- Access: Projects, saved servers, and evals.
- Client support: Remote MCP over Streamable HTTP with OAuth sign-in.
- Setup: No MCPJam installation or API key required.
Connect your client
- Server URL:
https://mcp.mcpjam.com/mcp - Client differences: Setup options and approvals vary by client, plan, and workspace.
- Claude Code
- Codex
- Cursor
- VS Code
- Claude
- ChatGPT
Add the remote server:Then run
/mcp, choose mcpjam, and sign in with your MCPJam account.See Claude Code’s MCP guide.Other MCP clients
Add a remote MCP server named MCPJam with the URLhttps://mcp.mcpjam.com/mcp, select Streamable HTTP if your client asks for
a transport, and complete OAuth sign-in in your browser. Clients that only
support local stdio servers cannot connect directly to this hosted endpoint.
Before you start
- An MCPJam account. Sign up at app.mcpjam.com. The free plan works.
- A project. Your agent can list your projects and create a new one, and every project tool falls back to your most recently updated project when you don’t name one.
- MCP servers to work with (optional). Servers you already saved in the MCPJam app are available right away. Your agent can also connect a new server by URL; when that server needs OAuth, it gives you a sign-in link to open.
- Plan and feature access. Some features depend on your plan, your project role, or features enabled for your account. Ask your agent what you can do in a project. It reads that from your account, and a tool you can’t use is refused with a clear error.
This server connects your agent to your MCPJam account. To inspect MCP
servers locally through an agent instead, see the CLI MCP server.
Verify the connection
Ask your agent:Use MCPJam to show which account I’m signed in with and list my projects.Check that it calls
get_me and list_projects and returns the account and
projects you expect. This checks the connection without changing your data
or spending MCPJam credits.
Sign-in and account access
The server is an OAuth 2.0 protected resource. Your client discovers MCPJam’s sign-in page from the server, you sign in with your MCPJam account, and the client receives a token for this server. Any request without a valid token is refused with401, which is what starts sign-in.
- Your access, no more. Each tool call is forwarded to MCPJam’s API with your token, so you see exactly the organizations and projects your account can see, and writes need the same role they need in the app.
- Nothing stored by the server. The server is stateless. It keeps no session and no copy of your token between requests.
- Credentials you save stay write-only. Server headers, environment values and client secrets you save are encrypted at rest. No tool returns a stored secret’s value.
- Disconnecting. Remove or disable MCPJam in your client’s MCP server, connector, or app settings to stop that client from calling MCPJam.
Tool permissions
Each tool declares what kind of action it is:- Read-only tools only read your account: listing projects, reading a run’s results, fetching a trace.
- Tools that create something new, such as a project, an eval suite or a run, are not read-only.
- Tools that change, replace, cancel, revoke or delete something that
already exists are marked destructive.
So are
call_server_toolandsend_chat_message, because they run tools on your own MCP servers, and those tools can do anything.
Costs
Most tools are free to call. These spend your organization’s MCPJam credits, or the model-provider keys your organization configured, and their descriptions say so:
These are included with MCPJam and are not charged to you, but they count
against per-minute and daily usage limits:
generate_eval_cases and
import_eval_cases. A tool that hits a limit is refused with RATE_LIMITED
and the time it can be called again.
Adding credits does not lift these limits.
Examples
See where things standWhich MCPJam projects do I have, and which servers are in the most recent one?Your agent uses
list_projects, then list_project_servers.
Check a server
Diagnose the “billing” server in my Payments project. It stopped connecting.Your agent uses
diagnose_server, which probes the URL, connects, and reports
what failed.
Run and read evals
Run the “checkout flows” eval suite in Payments and tell me which cases fail.Your agent uses
run_eval_suite, then get_eval_run until the run finishes,
then get_eval_run_steps for a failing case. The run spends credits; check
your client’s approval settings before requesting it.
Did a change break anything?
Compare the latest “checkout flows” run with the one before it.Your agent uses
compare_eval_run, which classifies each case as regressed,
fixed, new, removed, changed, or unchanged.
Add a server
Connect https://example.com/mcp to my Payments project.Your agent uses
connect_project_server. If the server needs OAuth, it gives
you a sign-in link to open, then calls get_project_server_connection_status
until the connection is ready.
Troubleshooting
Your client asks you to sign in again. Your MCPJam sign-in expired or was revoked. Reconnect MCPJam from your client’s MCP server, connector, or app settings and complete OAuth sign-in again. Your client cannot add the server or start sign-in. Confirm it supports Streamable HTTP and OAuth for remote MCP servers, and use the fullhttps://mcp.mcpjam.com/mcp URL. Check whether your client plan or workspace
policy restricts custom servers. Do not configure this endpoint as a local
stdio command or use the MCPJam CLI’s stdio configuration for it.
You see a different account’s projects. You signed in with another
MCPJam account. Disconnect MCPJam in your client, connect again, and choose the account
you meant on the MCPJam sign-in page. get_me shows which account your client is
using.
NOT_FOUND for a project, server, suite or run. The name or id did not
match anything your account can see. Project tools default to your most
recently updated project, so name the project when you have several.
403 FORBIDDEN. Your role or plan does not allow that action, or the
feature is not enabled for your account. A refusal for a feature carries
details.code: "FEATURE_UNAVAILABLE" and names the feature.
RATE_LIMITED. A usage limit was reached. The error says when the tool can
be called again.
TARGET_REQUIRED from run_eval_suite. The suite is attached to several
environments or clients. The error lists them; tell your agent which one to run.
Anything else. Email [email protected] with
the request id from the error message when there is one.
Privacy and terms
The MCP server processes your MCPJam data under MCPJam’s Privacy Policy and Terms of Use.- Tools that run models (evals, judges, Playground messages, and generation tools) send the content they work on to the model providers MCPJam uses.
call_server_toolandsend_chat_messagesend their inputs to your own MCP servers.send_feedbacksends the text you give it to the MCPJam team, where it is kept for 180 days.

