---
title: "Connect an MCP client."
description: "The protected Console MCP endpoint exposes quote, run and retrieval tools over stateless Streamable HTTP. Use an authorized MCP-channel credential."
canonical: "https://altss.com/console/docs/mcp"
last-updated: "2026-11-17"
---

# Connect an MCP client.

The protected Console MCP endpoint exposes quote, run and retrieval tools over stateless Streamable HTTP. Use an authorized MCP-channel credential.

Last modified: 2026-11-17

## Discover the protected resource

Read the resource and authorization-server metadata before selecting an authorization method.

```bash
curl --fail-with-body --silent --show-error 'https://console.altss.com/.well-known/oauth-protected-resource/v1/console/mcp'
curl --fail-with-body --silent --show-error 'https://console.altss.com/.well-known/oauth-authorization-server'
```

## Connect to the correct server

Use https://console.altss.com/v1/console/mcp for paid Console tools. Its credential needs the MCP channel and company.read scope. The public website’s /mcp reader is anonymous and serves published information; documentation MCP is another separate reader. Neither public reader executes a paid Console tool.

## Tool contract

| MCP tool | Purpose | Payment boundary |
| --- | --- | --- |
| altss_quote | Quote an available tool and exact input | No purchase |
| altss_run | Execute the unchanged accepted quote | Requires purchasing authority, wallet funding and permitted limits |
| altss_get_run | Retrieve an existing result and receipt | Does not buy the result again |


## Quote through tools/call

JSON-RPC request body after initialize. This requests a quote, not an execution.

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "altss_quote",
    "arguments": {
      "toolId": "company.financial_research",
      "input": {
        "cik": "0000789019"
      }
    }
  }
}
```

## Transport behavior

Send one JSON-RPC request per POST with Accept: application/json, text/event-stream. After initialize, use the negotiated MCP-Protocol-Version; the current published Console contract supports 2025-06-18. The endpoint is stateless, with no server-sent events or session state, and refuses batches. Supported methods include initialize, ping, tools/list and tools/call. Check the live contract before adapting a client’s transport assumptions.

## Authorization and errors

A manually issued or user-claimed credential must include MCP access. A supported authorization-code client uses the exact MCP resource, a public client metadata document and S256 proof; that flow issues MCP-only access. Check both the HTTP status and result.isError: a failed MCP tool call can return HTTP 200 with isError true. Preserve run and idempotency identifiers when recovering an uncertain execution.

## MCP integration references

- [Canonical authorization guide](https://altss.com/auth.md)
- [Console connection and error guide](https://console.altss.com/connect)
- [Anonymous public website MCP](https://altss.com/developers)
- [Usage and purchase controls](https://altss.com/console/usage-and-billing)

## Build your integration

- [Capability catalog](https://altss.com/console/capabilities)
- [REST API](https://altss.com/console/docs/api)
- [MCP](https://altss.com/console/docs/mcp)
- [A2A and agent discovery](https://altss.com/console/docs/a2a)
- [SDKs and examples](https://altss.com/console/docs/sdks-and-examples)
- [Usage and billing](https://altss.com/console/usage-and-billing)
- [Security and permissions](https://altss.com/console/security-and-permissions)

[Read the connection guide](https://console.altss.com/connect)

[Explore capabilities](https://altss.com/console/capabilities)

## Connect with the contract in view.

Start with the capability, its evidence requirements and the decision your team needs to make. Confirm the available tool and permitted use before execution.

[Read the connection guide](https://console.altss.com/connect)

[Discuss a requirement](https://altss.com/contact)

Canonical URL: https://altss.com/console/docs/mcp

