Integrations & MCP Server
Extend Renewly by connecting it to your existing tools. Access contract data from supported desktop tools, run automated portfolio analysis, and integrate with your workflow.
MCP Server Overview
The Model Context Protocol (MCP) Server lets you connect Renewly directly to any MCP-compatible client. Once connected, you can query your contract data, check renewal dates, and get portfolio summaries through natural conversation.
Pro Feature
Available MCP Tools
The MCP Server exposes five tools that any MCP-compatible client can use on your behalf:
get_upcoming_renewals
Returns a list of contracts with upcoming renewal or expiration dates, sorted by urgency. Use this to quickly see what needs attention.
get_contract_details
Retrieves full details for a specific contract, including parties, dates, value, risk analysis, and tags. Useful for deep-dives into individual agreements.
search_contracts
Searches your contract portfolio by keyword, vendor name, tag, or date range. Returns matching contracts with key summary data.
get_spend_summary
Provides a financial overview of your portfolio: total contract value, spending by vendor, spending by category, and period-over-period comparisons.
get_portfolio_health
Returns your portfolio health score, risk distribution, value at risk metrics, and key recommendations. A quick way to check your overall contract posture.
Setting Up the MCP Server
Connecting Renewly to a supported desktop tool takes about two minutes:
- Generate an API key: Go to Settings → Integrations and click "Generate API Key" if you have not already
- Copy the MCP config: On the same page, click "Copy MCP Config" to copy the JSON configuration to your clipboard
- Open your MCP client settings: In your MCP-compatible desktop tool, open the configuration or settings panel
- Paste the config: Add the copied JSON to your client's MCP configuration file
- Restart the client: Close and reopen your desktop tool to load the new configuration
- Verify: Ask "What contracts are expiring soon?" to confirm the connection is working
Keep your API key secure. Your MCP API key provides access to your contract data. Never share it publicly or commit it to version control. You can regenerate it at any time from Settings → Integrations.
Automated Portfolio Analysis
Automated portfolio analysis examines your contracts for patterns, risks, and opportunities that might not be visible when looking at contracts individually.
What It Does
- Identifies renewal clusters where multiple contracts expire around the same time
- Detects vendor concentration risks
- Flags spend anomalies and unusual contract terms
- Tracks risk trends across your portfolio over time
- Generates actionable recommendations for each finding
Automatic vs. Manual Analysis
Analysis runs automatically when your portfolio changes (new contracts added, edits made, contracts removed). You can also trigger a manual analysis:
- Go to the Insights page from the sidebar
- Click "Run Analysis" in the top-right corner
- Results appear within 30 seconds
REST API
For programmatic access beyond the MCP Server, Renewly provides a REST API. Generate API keys, authenticate requests, and access contract data from any application or script.
Troubleshooting
MCP Server Not Connecting
- Verify your API key is correct and has not been regenerated since you configured your MCP client
- Ensure the JSON config is valid (no trailing commas, properly quoted strings)
- Restart your MCP client after making config changes
- Check that your Pro subscription is active
Portfolio Analysis Not Running
- Ensure you have at least 3 completed contracts
- Check that your Pro subscription is active
- Try triggering a manual analysis from the Insights page
- If the issue persists, contact support@renewly.gg