Connect an agent
Add the OSINTverse MCP server to Claude, Claude Code, ChatGPT, Cursor, VS Code, a JSON config, or the Messages API, with OAuth or an API key.
Every client uses the same endpoint, https://osintverse.com/mcp. People sign in with OAuth; scripts send an API key.
- In Claude (web, desktop, or mobile) open Settings → Connectors and choose Add custom connector.
- Paste
https://osintverse.com/mcpand click Connect. - Sign in to OSINTverse. On the consent screen pick the wallet to bill (personal or a team you can search in) and set a daily cap for this agent. The agent starts in sandbox mode, so nothing is charged until you switch it to live.
- Ask Claude to quote and run a lookup. Paid tools ask for confirmation; reads do not.
Claude identifies itself with a Client ID Metadata Document, so there is nothing to register on your side.
Your first five minutes
Every new connection starts in sandbox mode: all the tools work, but searches return sample data and nothing is charged. Ask the agent to walk through these. Each step is one tool call.
whoami: which wallet it bills, the scopes you granted, both daily caps, andmode: "sandbox".list_providerswith aninput_typesuch asemail: who can look it up and at what price.quote_search(orquote_bulk_searchfor several identifiers or providers): what the lookup would cost live, and whether the balance and caps allow it.create_case, thenrun_searchorrun_bulk_searchwith thatcase_id: runs the lookup on sample data and files it in one go.get_case: everything filed so far, grouped by run.
When the workflow looks right, open Dashboard → API keys → Agents and choose Go live for that agent. Searches then return real results and charge your wallet, inside your caps. Every call, sandbox or live, shows up under Recent agent calls.
Which credential to use
| Credential | Who it identifies | Scopes | Where it bills |
|---|---|---|---|
| OAuth sign-in | You, per connected app | osint:read, search:run, cases:write as granted | The wallet chosen on the consent screen |
ov_ API key | The key's owner (personal) or the team | Set by the key's access level: read only (osint:read), search and read (+ search:run), or full (all three) | Same wallet as the REST API, within the key's own daily cap if it has one |
Both are limited by the workspace's daily agent cap and the per-call rate limits (60 tool calls and 10 paid searches per minute). OAuth connections can also have their own cap that counts only their spend.
Demo endpoint
https://osintverse.com/mcp/demo needs no credential, returns fixed sample results, and never bills. Use it to confirm your client connects before you sign in.
MCP server
Connect Claude, Cursor, VS Code, or your own agent to OSINTverse over the Model Context Protocol and run OSINT lookups with a daily spend cap.
Agent frameworks
Connect OSINTverse to agents you build with the Claude Agent SDK, the OpenAI Agents SDK, LangChain, or n8n, and find the server by discovery.