Connect Claude Code
Claude Code connects straight to the hosted Evinor MCP endpoint over HTTP, with your API key sent as a bearer token.
The fastest way: Developers → Agent setup
In the Evinor web app, open Developers → Agent setup
(/agent-setup), pick your agent, and create the key. Evinor creates a dedicated API key that expires after 90 days and
builds the setup text below with that key already filled in. Copy it and paste
it into your agent, or follow the steps yourself.
By default the key gets every scope your account is allowed to grant. Open Adjust access before creating it to narrow that down. The scopes are fixed once the key exists.
The raw key is shown only while that page stays open. If you leave and come back, you create a new key. Each key uses one of the ten active-key slots on your account until you revoke it, even after it expires.
Set it up yourself
-
Run this command in a terminal, with your own
evnr_live_…key:claude mcp add --transport http evinor 'https://api.evinor.ai/mcp' --header 'Authorization: Bearer evnr_live_…' -
Start (or restart) Claude Code, then run
/mcpand check that theevinorserver and its tools are listed.
The command stores the key in Claude Code's MCP configuration. The single quotes keep your shell from interpreting anything inside the URL or the header.
Keep the key safe
- The key now sits in your agent's config and conversation history. Treat that file like a password: keep it out of version control and shared folders.
- Revoke the key under Developers → API keys when you stop using the agent, or as soon as you think it leaked. An expired key is refused but still holds a slot until you revoke it.
- Use a separate key per agent or machine, so you can revoke one without breaking the others.
Before you let the agent create sensors
A key with SENSORS_WRITE lets the agent create sensors. A sensor sends every
matching event to the webhook URL it was created with, and the agent chooses
that URL. Text inside search results comes from news coverage, so it could try
to steer the agent towards a URL you do not control. Check the destination URL
whenever your agent asks to create a sensor, or leave SENSORS_WRITE off the
key. See The sensor tools.
What to do next
Once the tools are listed, ask the agent what you want: search recent events,
follow a topic as a beat, or set up a sensor. The server tells the agent how
sensors, beats and credits work when it connects. Every search_events call
is charged; see Billing.
For the full tool list, scopes and errors, see MCP server.