Q2 Developer MCP Server

Search and retrieve Q2 developer documentation through the Model Context Protocol

📚 About

This MCP server provides AI assistants with access to comprehensive Q2 developer documentation including SDK guides, API references, mobile development docs, and frontend frameworks. Your AI assistant can search across all documentation sources and retrieve specific documents to answer your questions.

🛠️ Available Tools

  • search_docs(query, doc_source?) — Search across Q2 docs. doc_source is optional and can be sdk, mobile, tecton, or api.
  • retrieve_doc(filename, doc_source, offset?, limit?) — Retrieve a document by filename from a specific source, with optional pagination.

📖 Documentation Sources

This MCP server provides access to the following Q2 documentation:

  • Q2 SDK: Core SDK documentation for building Q2 applications
  • Q2 Mobile SDK: Mobile development documentation for iOS and Android
  • Tecton Frontend: Tecton UI framework documentation
  • Caliper API: REST API documentation for Q2 Banking platform

🔐 Authentication

OAuth 2.1 (Recommended)

Automatic authentication through Q2 Developer login. Your MCP client will open a browser window for you to authorize access. FastMCP session tokens are refreshed locally; Q2 platform passthrough may require re-authentication after the upstream Q2 token expires.

Personal Access Token

Generate a token from Q2 Developer Settings. Base64-encode it as email:pat, then send it as Authorization: Bearer base64(email:pat). Identity metadata is cached for normal requests, and the upstream Q2 token is loaded or refreshed only when passthrough tools need it.

PAT Authentication Format: Base64-encode your email and PAT in the format email:pat, then send it as Authorization: Bearer <base64_token>. Example: echo -n "user@example.com:your_pat" | base64

⚙️ Configuration Generator

Generate Your MCP Configuration

🧪 Testing Your Connection

To test your MCP configuration with the official MCP Inspector:

  1. Use the Configuration Generator above to create your config
  2. Click the Download button to save as mcp.json
  3. Run the MCP Inspector from the same directory:
npx @modelcontextprotocol/inspector --config mcp.json

The inspector will authenticate and display all available tools if the connection is successful.

❓ Need Help?