Docs
Start building
Developers

MCP API

The MCP server is JSON-RPC over HTTP, so you can call it from any language — not only from AI assistants.

The endpoint

URLhttps://webforgia.com/api/mcp
TransportStreamable HTTP — POST only
ProtocolJSON-RPC 2.0, MCP version 2025-06-18
AuthAuthorization: Bearer wf_live_…
Limits120 requests a minute per address; batches of up to 20 calls

Methods

  • initialize — returns the protocol version and server information.
  • tools/list — the tools this key’s scopes allow.
  • tools/call — run a tool with its arguments.
  • ping — a health check.

Calling a tool

Request
curl -X POST https://webforgia.com/api/mcp \
  -H "Authorization: Bearer $WEBFORGIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_projects","arguments":{}}}'

Results come back as MCP content — a text block holding the tool’s JSON result. A tool that refuses (a missing scope, no credit) returns isError: true with a readable message rather than an HTTP error, so an assistant can act on it.

Every tool and its arguments: Available Tools.