Stimulus in Claude and ChatGPT
The Stimulus connector lets Claude, ChatGPT and other assistants that speak the Model Context Protocol (MCP) ask Stimulus about the relationships your organisation already has. It works from your organisation's own record, and every answer shows where it came from.
What it is for
It is for the people in an organisation who work with suppliers and other businesses, and who already use Claude or ChatGPT: procurement and finance first, and the teams that buy from and work with businesses after them. You ask in your own words and your assistant calls the tools below.
- Before a sourcing deadline, ask which suppliers your organisation already has a history with for a need, and see the sources behind each answer.
- Open your brief from inside Claude or ChatGPT and see which relationships have gone quiet or have terms about to expire.
- Look up a business before a call and get everything your own record holds about it, with the message or file each fact came from.
Before you connect
- A Stimulus account, in an organisation. Connecting an assistant does not create one. Sign up at Stimulus if you do not have one.
- At least one connected source or uploaded file in your workspace. With nothing connected there is little for the tools to return.
- The connection acts as you. It can reach only what you can reach in Stimulus, in the organisation you connect it to.
Connect
The server address is https://mcp.getstimulus.ai/api/mcp.
You sign in with your Stimulus account and approve the connection on a consent screen. You never copy a token.
Claude (claude.ai and Claude Desktop)
Open the connectors settings, add a custom connector with the server address, then sign in and approve.
ChatGPT
In ChatGPT developer mode, add an app with the server address, then sign in and approve.
Claude Code
claude mcp add --transport http stimulus https://mcp.getstimulus.ai/api/mcpThen run /mcp in Claude Code and choose Stimulus to sign in.
Other MCP clients
Add the server address to any client that supports remote MCP servers with OAuth.
With a personal token (Claude Code, Codex and other clients)
Personal tokens stay available for tools that run on your own machine. In Stimulus, open Settings, then Assistants, and create a connection. The token is shown once. It lasts 30 days and acts as you.
Claude Code:
claude mcp add --transport http stimulus https://mcp.getstimulus.ai/api/mcp --header "Authorization: Bearer <your token>"Codex, in the config file, with the token in the environment:
[mcp_servers.stimulus]
url = "https://mcp.getstimulus.ai/api/mcp"
bearer_token_env_var = "STIMULUS_MCP_TOKEN"Any other client: send Authorization: Bearer <your token> to the server address.
Tools
Five tools. Four read from your record and cost nothing. One, ask_stimulus, runs the Stimulus agent and can change things, so assistants treat it as a tool that writes.
| Tool | Reads or writes | What it does | Cost |
|---|---|---|---|
get_context | Reads | Who the connection acts for and what the organisation's workspace holds: the organisation, your role, and the ten businesses found most recently. Assistants call it first to orient. | No credit |
get_brief | Reads | Your brief: up to ten businesses that need attention now, such as a relationship gone quiet, terms about to expire or a follow-up overdue, most urgent first, each with the reason it is there. | No credit |
search | Reads | Finds businesses in the organisation's workspace by name or domain. Returns up to ten, best match first, each with an id for fetch. | No credit |
fetch | Reads | Everything the organisation's workspace records about one business, by the id search or get_brief returned, with the sources behind it. | No credit |
ask_stimulus | Writes | Asks Stimulus a question in your own words and returns its answer with the sources behind it. Use it when the answer needs judgement across the record. Stimulus can record what it learns in your record and research public sources while it works, which is why this tool is marked as one that can change things. | Uses credits from the organisation's daily budget |
The four reads run under your own access and leave a decision record, the same as the app. They return businesses and what your record holds about them. They do not return people search or profiles, scores of relationship strength, or anything from another organisation.
Approvals
Nothing is sent from your accounts without a person's approval. Approval happens in Stimulus, not inside your assistant.
- A question asked through the connector runs on its own, with nobody at the keyboard to approve a step. It can answer from your record, research public sources, and take actions in your connected accounts, but an action that needs your approval is not performed from the connection: where your organisation allows it, it waits for you in Stimulus.
- A question asked through the connector never runs in Bypass, even if you have chosen Bypass for your own agent in Stimulus.
- Assistants that act on a tool's hints, such as Claude, ask you before they call
ask_stimulus, because that tool is marked as one that can change things.
Your data
- We receive only the tool arguments the assistant sends, such as a question or search term, not its conversation history. Questions and answers from ask calls are retained in your Stimulus conversation.
- Imported companies' profiles are published to the Stimulus network only if your organisation opts in; this setting is off by default. A member's explicit self-contribution still publishes.
- The assistant sees only what a tool returns to it. The Stimulus agent is told not to include email addresses, phone numbers or internal ids in an answer.
- What a tool returns is shared with the assistant you connected, and so is handled under that provider's terms and privacy policy.
- Every read leaves a decision record. Each
ask_stimuluscall is also recorded: who asked, which connection, when, its status and the credits it used. Stimulus stores a digest of the question there; the question itself is kept once, in your own conversation in Stimulus. - How Stimulus handles information, and the providers it uses, are in the Privacy Policy and on the Security page.
Limits
The four reads have no credit cost. Each question to ask_stimulus uses credits from your organisation's daily budget, and a single connection has its own daily cap. A question that is refused, or that fails, costs nothing, and the answer says whether trying again can help. If an answer takes longer than the assistant will wait, it comes back as still working: ask again with the same question and the same idempotency_key to collect it at no cost.
Disconnect
- In Stimulus, open Settings, then Assistants, and choose Revoke on the connection. The next request from that assistant is refused with a 401.
- Removing the connector in Claude or ChatGPT stops that assistant calling Stimulus. Revoke the connection in Stimulus as well if you want it ended on our side.
- A personal token also expires on its own after 30 days.
Support
Email support@getstimulus.ai and say which assistant you use. For security reports, see the Security page.
Related: Privacy Policy, Terms of Use, Integrations.