MCP Server
Inherent ships an MCP (Model Context Protocol) server so AI assistants can search your knowledge base, retrieve documents, and upload new content -- all through a standard, open protocol.
Available on Pro and Business plans.
What is MCP?
Model Context Protocol is an open standard that lets AI assistants access external data sources and tools. Instead of copy-pasting context into every prompt, MCP lets your assistant pull the right documents automatically.
Setup
You need an API key before connecting. See the Authentication guide to create one.
Claude Desktop
Add the following to your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"inherent": {
"command": "npx",
"args": ["-y", "@inherent/mcp-server"],
"env": {
"INHERENT_API_KEY": "inh_live_your_api_key",
"INHERENT_API_URL": "https://api.inherent.sh"
}
}
}
}
Restart Claude Desktop after saving.
Cursor
Add the following to .cursor/mcp.json in your project root:
{
"mcpServers": {
"inherent": {
"command": "npx",
"args": ["-y", "@inherent/mcp-server"],
"env": {
"INHERENT_API_KEY": "inh_live_your_api_key",
"INHERENT_API_URL": "https://api.inherent.sh"
}
}
}
}
Restart Cursor after saving.
Available Tools
Once connected, the following tools are available to your AI assistant:
| Tool | Description | Required Permission |
|---|---|---|
search | Semantic search across all documents in a workspace | Read |
get_document | Retrieve a specific document by ID | Read |
get_chunks | Get individual chunks for a document | Read |
upload_document | Upload a new document to a workspace | Write |
All tools are scoped to the workspace associated with your API key.
Example Usage
Once configured, you can ask your AI assistant questions like:
- "Search my knowledge base for deployment procedures"
- "Get the full contents of the onboarding guide"
- "Upload this markdown file to the docs workspace"
The assistant will use the MCP tools automatically to fetch the relevant context.
Rate Limits
MCP requests count toward your plan's rate limits. See the Authentication guide for details.
Troubleshooting
| Issue | Solution |
|---|---|
| "Server not found" after setup | Restart your AI assistant completely (quit and reopen) |
| "Authentication failed" | Verify your API key is correct and not revoked |
| "Permission denied" on upload | Your API key may be read-only; create a new key with write access |
| Tools not appearing | Check that the config file path is correct for your OS |
| Slow responses | Check your network connection to api.inherent.sh |
| "Rate limit exceeded" | You have hit your plan's request limit; wait or upgrade your plan |