Overview
Minoa exposes an MCP (Model Context Protocol) server that lets any compatible AI client access your sales data — business cases, pipeline analytics, value frameworks, and more — through a standardized interface. If you’re using a platform that supports MCP, you can connect it to Minoa in minutes.Supported Platforms
We have step-by-step setup guides for these platforms: Using a different MCP client? The configuration below works with any client that supports the MCP protocol. See Connecting Any MCP Client for generic setup instructions.MCP Server URL
Your Minoa MCP server URL will be provided when you’re granted beta access. Contact support@minoa.io to get your URL.Authentication
Minoa uses OAuth 2.0 to authenticate MCP connections. The server supports:- Authorization Code grant type with PKCE
- Standard OAuth discovery via
/.well-known/oauth-authorization-server
How it works
- Your MCP client initiates an OAuth flow against the Minoa server
- You’re redirected to Minoa to sign in with your own account
- You authorize the client to access your workspace data
- The client receives an access token scoped to your workspace
OAuth Endpoints
| Endpoint | URL |
|---|---|
| Authorization | {MCP_SERVER_URL}/authorize |
| Token | {MCP_SERVER_URL}/token |
| OAuth Discovery | {MCP_SERVER_URL}/.well-known/oauth-authorization-server |
Available Tools
Once connected, your MCP client can use the following tools:| Tool | Description |
|---|---|
list_business_cases | Search and list business cases by name or status |
get_business_case | Get full details of a specific business case |
get_value_framework | Get all use cases from your value framework library |
get_value_hypothesis | Get the AI-generated value hypothesis for a deal |
get_pipeline_analytics | Pipeline metrics, win rates, and trends |
get_use_case_analytics | Use case effectiveness and win rates |
create_smart_business_case | Create a new business case with AI-recommended use cases |
Available Resources
MCP resources allow clients to read structured data directly from Minoa.| Resource | Description |
|---|---|
| Value Framework | All active use cases with calculations and tags |
| Business Case | Full details including scenarios and financials |
| Value Hypothesis | AI-generated value narrative for a deal |
Connecting Any MCP Client
If your MCP client isn’t listed in our platform guides, you can connect it manually using the information above. Here’s what you’ll need:For clients with OAuth discovery (recommended)
Most modern MCP clients can auto-discover OAuth endpoints. Just provide:- MCP Server URL — the URL provided by Minoa
- The client will discover authorization and token endpoints automatically via
/.well-known/oauth-authorization-server
For clients requiring manual configuration
If your client doesn’t support auto-discovery, configure these settings:| Setting | Value |
|---|---|
| Server URL | Your Minoa MCP server URL |
| Authorization URL | {MCP_SERVER_URL}/authorize |
| Token URL | {MCP_SERVER_URL}/token |
| Grant Type | Authorization Code |
| Scope | read |
| Auth Method | Body |
Transport
The Minoa MCP server supports Streamable HTTP transport:- SSE endpoint —
GET {MCP_SERVER_URL}/(or/ssefor backwards compatibility) - Message endpoint —
POST {MCP_SERVER_URL}/(or/messagesfor backwards compatibility)
Security
- All requests are authenticated via OAuth and scoped to your Minoa workspace
- Clients can only access data the authenticated user has permission to view
- Access tokens can be revoked at any time by disconnecting from your MCP client
- The server enforces rate limits to prevent abuse
- All connections use TLS encryption
Troubleshooting
OAuth flow doesn’t start
Make sure your MCP server URL is correct and includes the full path. The server exposes discovery endpoints at/.well-known/oauth-authorization-server — if your client can’t reach these, double-check the URL.
”Missing or invalid required parameters” on token exchange
Some clients sendclient_id in the HTTP header instead of the request body. Set Authentication to Body in your client’s OAuth configuration.