Custom MCP

Build a custom Grok MCP connector from OpenAPI.

Custom Grok connectors should start from the API contract, not a hand-maintained list of endpoints. Sourced converts OpenAPI into a remote MCP pack and blocks risky defaults before setup.

  • InputOpenAPI spec
  • LanguagesTS + Python
  • DocsPreview + llms.txt
  • ReleaseLaunch checks

01Outputs

The generated connector shape

01

server_url points to your deployed MCP endpoint.

02

server_label is derived from the API name and safe for reuse across snippets.

03

allowed_tools includes only non-sensitive read tools by default.

04

authorization and headers are documented for hosted MCP protection when needed.

02Details

Auth and hosting

01

No hosted URL means no Grok remote connector yet; Sourced gives you the expected config after hosting.

02

OAuth/OpenID Connect specs are blocked until callback URLs, storage, refresh, and consent are reviewed.

03

Authenticated APIs over non-local HTTP are blocked until the base URL moves to HTTPS.

04

The generated MCP server reads API credentials from environment variables, not from chat-visible tool inputs.

03Details

Review before expose

01

Read-only public-list operations can be enabled first.

02

Sensitive read operations, like API keys or account users, stay out of the default allowlist.

03

Write and destructive operations require an owner-approved allowlist change.

04

The same pack includes tests proving destructive tools are not default-enabled.

04Details

Customer-owned repo path

01

Sourced keeps GitHub writes out of the Grok path for launch; commit the downloaded pack to an owner-approved repo before deployment.

02

The generated PR plan is local to your repo and never targets xAI-owned repositories.

03

Draft PR creation should remain explicit and owner-approved.

04

The pack includes a review body so a maintainer sees files, risks, and tests before merging.