FetchBeta

AI & MCP

Your AI, not ours

Fetch has an MCP server, API keys and OAuth, so Claude or any other agent can drive it. We don't sell AI: anything AI in Fetch runs on your own provider key.

The MCP server

https://fetch.nightroll.app/mcp

Streamable HTTP, JSON responses. Every tool call is checked against the key's scopes and written to your organization's audit log.

With an API key

For Claude Code, scripts and any MCP client that sends headers. Create a key in Settings → API keys (scoped, with an expiry), then:

claude mcp add --transport http fetch https://fetch.nightroll.app/mcp --header "Authorization: Bearer $KEY"

With OAuth

For claude.ai and Claude Desktop: add the URL above as a custom connector. You sign in, pick the organization and the permissions, and approve. Disconnect any time from Settings → API keys.

What your agent can do

  • Import Postman collections, OpenAPI specs and cURL commands
  • Create, edit and organize requests, folders and environments
  • Send requests from Cloudflare and check the responses
  • Run collections and set up monitors with assertions
  • Publish mock servers and API docs
  • Push and pull workspaces with GitHub

Tools

An agent sees only the tools its scopes allow: read, write or admin, never more than the person's role.

ToolWhat it doesScope
orgs_exportExport everything in an organization (workspaces, collections, environments, specs, history) as NDJSON: one entity per line.admin
workspaces_listWorkspaces you can see in an organization.read
workspaces_createCreate a workspace.write
workspaces_updateRename a workspace or change its description or visibility.write
workspaces_deleteMove a workspace and everything in it to the trash (restorable for 30 days).write
items_listList items (collections, folders, requests, environments, specs, mocks, monitors...) by workspace, kind or parent, or search them by name.read
items_getOne item with all its fields.read
items_treeA collection or folder with all its folders, requests and examples, nested.read
items_createCreate an item: a collection, folder, request, example, environment, spec, package and so on.write
items_updateChange an item's name, place or fields.write
items_deleteMove an item (and what's inside it) to the trash, restorable for 30 days.write
items_restoreTake an item out of the trash.write
items_purgeDelete an item from the trash for good.write
items_duplicateCopy an item and everything inside it.write
items_historyVersion history of an item: every change, who made it and when.read
items_revertPut an item back the way it was at a point in its history.write
searchSearch everything in the organization by name, URL and description.read
catalog_listThe API catalog: every collection and spec with its docs, mocks and MCP servers.read
files_uploadGet a link to upload a file (request bodies, test data) straight to storage.write
files_confirmConfirm an upload finished.write
files_urlA short-lived download link for a file.read
github_reposWhether you've connected GitHub, and the repositories you can link (most recently pushed first).read
github_disconnectForget your GitHub connection for this organization.write
git_statusA workspace's GitHub link and what differs: files changed in Fetch (push sends them), on GitHub (pull brings them) or both (conflicts). Collections and environments are kept as Fetch YAML files.read
git_linkLink a workspace to a folder of a GitHub repository and branch, or unlink it (empty `repo`).write
git_pullBring GitHub's changes into the workspace (and settle conflicts with `resolve`).write
git_pushCommit the workspace's changes to GitHub (pull first when GitHub has changes).write
git_diffA changed file in the workspace and on GitHub.read
git_logRecent commits to the linked folder.read
git_branchesThe linked repository's branches.read
requests_sendSend a request through the cloud executor (public internet only) and get the response, test results and console output. For localhost or private networks, use the Fetch Agent instead.write
runs_startRun a collection or folder (optionally many iterations with CSV/JSON data) in the cloud. Returns the run, which progresses in the background.write
runs_getA run's status and results.read
runs_listRecent runs (collection runs, monitors, CI, contract tests).read
runs_cancelStop a run.write
runs_reportA run's report as JUnit XML, JSON, HTML or CTRF.read
history_listYour requests sent from the cloud in a workspace, newest first, kept 30 days: method, URL, status, time, size, tests and error. history.get adds the request and response. Browser and agent sends stay on their device.read
history_getOne cloud send with its request and response (the first 256 KB of the body, kept 30 days): a history entry, or a request of a cloud collection run or monitor check (the run's id and the request's `step` in its results).read
history_clearClear a workspace's request history.write
monitors_createCreate a monitor: run a collection on a schedule and alert on failures.write
monitors_runRun a monitor now.write
importImport a file: cURL, Postman (v2.0, v2.1, v3 YAML), OpenAPI 3.x, Swagger 2.0, GraphQL or Fetch YAML. The format is detected.write
exportExport a collection, folder, request or environment as Fetch YAML, Postman v2.1, OpenAPI 3.1 or cURL.read
codegenGenerate code that sends a request, in any of 20+ languages and libraries.read
codegen_targetsLanguages and libraries codegen can write.read
curl_parseTurn a cURL command into a request.read
specs_to_collectionGenerate a collection from a spec (or update the linked one).write
collections_to_specGenerate an OpenAPI 3.1 spec from a collection.write
docs_publishPublish (or unpublish) a collection's documentation, with an llms.txt for AI tools.write
mocks_createCreate a mock server from a collection's saved examples.write
hosted_urlThe public URL of a mock, catcher, hosted MCP server or published docs.read
whoamiWho the key or token belongs to: person, organization, role and scopes.read
list_membersThe organization's members and their roles.read
invite_membersInvite people by email, with a role.admin
list_invitesOpen invites.admin
revoke_inviteRevoke an open invite.admin
get_usageUsage and cost for a month, per meter.admin
list_audit_eventsThe audit log, filtered by person, action and dates.admin

Bring your own key

Fetch's in-app assistant runs in your browser on your own Anthropic, OpenAI or OpenRouter key (or any OpenAI-compatible endpoint); the key stays on your device. Your key stays in your browser: it never reaches our servers, and your provider bills you directly.

We don't sell AI

No AI credits, no markup on tokens, no training on your data. You choose the model and the provider, and you pay them directly.

Connect in a minute

Step by step, with example prompts.

QuickStart