Jina Docs
MCP

Admit workflows over MCP

Use the trusted MCP endpoint to start review and reference workflows through one framework.

Endpoint and authorization

Jina exposes stateless Streamable HTTP MCP at the product API /mcp route. It is an operator surface protected by the internal bearer credential, not a public repository-context server.

Production endpoint
https://api.usejina.com/mcp

Available tools

  • review — admit one pull-request review with exact GitHub installation, repository, pull-request, and head-SHA identity.
  • hello_world — exercise the minimum work-request, dispatch, claim, and completion path.
  • find_issue — create a typed issue result and atomically promise a fix-issue follow-up request.

Codex configuration

Store the operator token in the process environment. Never commit or paste it into repository configuration.

~/.codex/config.toml
[mcp_servers.jina]
url = "https://api.usejina.com/mcp"
bearer_token_env_var = "JINA_PRODUCT_INTERNAL_API_TOKEN"
enabled_tools = ["review", "hello_world", "find_issue"]

Idempotency

Supply a stable idempotency key when a caller may retry. The framework rejects a reused semantic identity whose canonical request differs and returns the existing request for an exact replay.