🤖 MCP integration for AI agents
Hosted MCP server at https://ivoque.de/mcp-rpc — 20 ready-made tools, no npm install. Plug NeuralIndexer straight into Claude Desktop, Cursor, Windsurf, ChatGPT or any other MCP-compatible AI tool.
What is MCP
Model Context Protocol is an open standard by Anthropic that lets AI assistants safely call external tools. Our hosted server exposes the entire NeuralIndexer REST API as 20 typed tools, and the assistant picks the right one based on context.
Zero install — just a URL and a token
No npm package, no Node.js runtime, no extra server to run. Paste https://ivoque.de/mcp-rpc
and your token into your client config — and the AI agent is ready to submit URLs for indexation.
Get an API token
There is no public token — every account has its own. Sign up and grab a token via one of the two paths below:
⚠️ Generating a new token immediately invalidates the previous one.
3 steps to AI-driven indexation
-
1
Register and get a tokenVia @InderixingBot ($0.38 bonus) or the email sign-up form ($0.05 test). Generate an API token in the cabinet.
-
2
Paste the hosted MCP URL into your clientCopy a JSON snippet below for Claude Desktop / Cursor / Windsurf / ChatGPT, replace
YOUR_API_TOKEN, restart the client. -
3
Talk to your AI agentAsk the model to check balance, submit URLs or subscribe to a webhook. Cost-guard prevents accidental large charges.
Cursor
Open ~/.cursor/mcp.json
or Settings → MCP → Add new MCP Server,
paste the JSON below, replace YOUR_API_TOKEN
and restart Cursor.
{
"mcpServers": {
"ivoque": {
"url": "https://ivoque.de/mcp-rpc",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Claude Desktop
In Claude Desktop, open Settings → Connectors → Add custom connector:
Connector URL: https://ivoque.de/mcp-rpc Authentication: OAuth → use "Bearer token" Bearer token: YOUR_API_TOKEN
Older Claude Desktop builds without the Connectors UI can use the local stdio variant.
Windsurf
Open ~/.codeium/windsurf/mcp_config.json
and add:
{
"mcpServers": {
"ivoque": {
"serverUrl": "https://ivoque.de/mcp-rpc",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
ChatGPT
Settings → Connectors → Custom connector:
Name: NeuralIndexer Description: URL indexation in Google, Bing, Yandex URL: https://ivoque.de/mcp-rpc Authentication: Bearer token Bearer token: YOUR_API_TOKEN
Health-check
Verify connectivity from your machine before wiring the server into your client:
curl https://ivoque.de/mcp-rpc
# {"status":"ok","server":"@ivoque/mcp","transport":"streamable-http",...}
curl -X POST https://ivoque.de/mcp-rpc \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Account & Billing — 2 tools
ivoque_check_balance
Current balance, price per link, available link count.
free
ivoque_get_balance_history
Paginated debit/credit ledger linked to submissions.
free
Submissions — 8 tools
v2 (preferred)
ivoque_submit_v2
Auto-split >5000 URLs, idempotent via client_batch_id, slow / fast / yandex.
depends on queue
ivoque_list_submissions
List with filters: status, engine, label, dates.
free
ivoque_get_submission
Full detail of one submission + sample URLs.
free
ivoque_get_submission_links
Paginated URLs with live indexation_status. only_status: not_indexed for re-submission.
free
ivoque_get_submission_parts
Per-part progress of a multi-part submission.
free
v1 (legacy)
ivoque_submit_links
Slow Google + Bing.
$0.0122 / URL
ivoque_submit_links_fast
Fast Google Indexing API.
$0.50 / URL
ivoque_submit_links_yandex
Yandex only.
$0.0122 / URL
Indexation Checks — 4 tools
ivoque_check_indexation
Schedule a Google check (returns task_id).
$0.0024 / URL
ivoque_get_indexation_check_status
Poll status & results (legacy task_id).
free
ivoque_list_indexation_checks
List of all v2 checks (auto + manual).
free
ivoque_get_indexation_check_v2
V2 check detail with per-URL results.
free
Webhooks — 6 tools
Subscribe to events submission.completed,
check.completed,
balance.changed.
Each delivery is signed with HMAC-SHA256.
ivoque_list_webhooks
List account subscriptions.
free
ivoque_create_webhook
Create a subscription. The HMAC secret is returned exactly once.
free
ivoque_update_webhook
Update url / events / is_active / description.
free
ivoque_delete_webhook
Delete a subscription.
free
ivoque_get_webhook_deliveries
Last 30 days of delivery attempts.
free
ivoque_test_webhook
Send a synthetic test event to your receiver.
free
Safety guards
Every paid tool requires confirm_estimated_cost_usd. The MCP server refuses the call if the sum disagrees with the calculation by more than 5%.
Max 1000 URLs per MCP call (configurable via env). Larger batches must be split client-side.
A token-bucket in the HTTP client prevents exceeding the Ivoque IP-level limit of 50 req / 10 sec.
🔒 Each request to /mcp-rpc spawns an isolated MCP instance scoped to your token. Tokens are never written to disk — only kept in memory for the duration of one request.
Example agent prompt
You say to the AI assistant:
I have 200 URLs from sitemap.xml. Submit them via NeuralIndexer slow indexation, set client_batch_id="weekly-2026-04-28" so reruns do not double-charge, then subscribe my Make.com webhook https://hooks.example.com/done to submission.completed and check.completed. A few days later, list URLs from that submission that are not indexed yet.
What the agent does:
ivoque_check_balance— check the balanceivoque_submit_v2withqueue:"slow",client_batch_id:"weekly-2026-04-28"andconfirm_estimated_cost_usd:2.44(200 × $0.0122)ivoque_create_webhookwithevents:["submission.completed","check.completed"]— the receiver gets an HMAC secret for verification- Days later:
ivoque_get_submission_linkswithonly_status:"not_indexed"— a list of URLs to re-submit
Local stdio (advanced / offline)
Need to run the MCP server fully on your own machine — for air-gapped networks, low-latency batch jobs, or combining with other local-only tools? The same code is packaged as a stdio CLI.
{
"mcpServers": {
"ivoque": {
"command": "node",
"args": ["/absolute/path/to/ivoque-mcp/dist/index.js"],
"env": { "IVOQUE_API_TOKEN": "YOUR_API_TOKEN" }
}
}
}
Source, build instructions and the npm tarball are available on request from @Inderixing (public npm release coming soon).
REST API without MCP
The same functionality is also exposed as a plain REST API — for CI/CD, dashboards, the WordPress plugin or integration into your own tools.
Open API documentation →