Cursor
Add the Hermes AI API MCP server to Cursor's mcp.json and connect with OAuth.
Add the MCP server
Add this to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json in one project.
mcp.json
{
"mcpServers": {
"hermes-ai-api": {
"url": "https://api.hermes-ai.net/mcp"
}
}
}Sign in
Open Cursor Settings → MCP and choose Connect next to hermes-ai-api. Sign in with Google or GitHub and allow the request.
- What the app can do: Run models and spend your prepaid credits, and read your tasks, results and balance.
- What it cannot do: Manage API keys, billing or payments, or use any admin feature.
- Disconnect any time: Account security lists every connected app. Disconnecting stops its access immediately.
MCP tools
Once signed in, ask in plain language. Your agent picks a model, shows the price and runs the task with these tools:
| Tool | What it does |
|---|---|
search_models | Find models by output type or keywords, with prices. |
get_model | Read a model's input fields, allowed values and current price. |
create_task | Run a model. Charges credits only if the task succeeds. |
wait_for_task | Wait until a task finishes and return its results. |
get_task | Check a task. Finished images are returned inline. |
list_tasks | List your recent tasks. |
get_balance | Show available, reserved and spent credits. |
Let your agent do the setup
Prefer one step? Copy the setup prompt from the Agents page into your agent; it runs these steps for you. Agents