https://app.raisegate.com/api/mcp (15 tools, same API keys, same scopes and rate limits). The guidance below applies to it and to any custom agent built directly on the REST API.
One tool per workflow step
One tool per workflow step
list_companies, get_company, add_company (with an Idempotency-Key per call), update_company, refresh_company, list_signals, list_alerts, list_leads, get_lead, track_lead, decide_lead, remove_company.Keep lists compact
Keep lists compact
Keep list tools on the compact view (the default) and fetch full detail only for the item the user is looking at. Compact
/tracker is ~3k tokens per 25 items versus ~34k for full.Prefer create-then-poll
Prefer create-then-poll
Draft enrichment (
POST /tracker/enrich) can exceed typical MCP tool timeouts. Create returns in seconds with a poll URL.Mark destructive tools
Mark destructive tools
Annotate removing a company (
DELETE), pausing, and rejecting leads as destructive so MCP clients confirm with the user first.Pass fuzzy names straight through
Pass fuzzy names straight through
Let the user say “Anomaly Bio”. Show
409 ambiguous_* candidates to the user instead of choosing one.Respect 429
Respect 429
Back off for
Retry-After seconds. Never loop creates or refreshes.Dedicated key per agent
Dedicated key per agent
Isolates usage, limits and revocation.
Give an agent the Partner API