Q4 MCP connector
Q4 runs a remote Model Context Protocol server for Saudi listed-company research. It gives AI clients cited access to Tadawul issuers, filings, news and earnings call transcripts, not raw file downloads.
The MCP server and the REST API read the same data. Use MCP for assistants and agents, and the REST API for your own code.
Who it's for
Analysts, investor-relations teams and AI client administrators who want Claude, or another MCP client, to answer questions about Saudi listed companies from Q4's research corpus.
Each person signs in with their own Q4 account. There is no organisation-wide SSO or tenant isolation in this version: every entitled user sees the same Tadawul universe.
Endpoint
Production MCP URL (Streamable HTTP):
https://api.q4.sa/mcp- Health check (no auth):
https://api.q4.sa/mcp/health - Authentication: OAuth 2.1 with PKCE (S256). Always required.
- Client registration: CIMD (the client ID is an HTTPS metadata URL). No dynamic client registration.
- Access token: a 7-day JWT. Q4 does not issue refresh tokens.
Connect Claude
- In Claude, add a custom connector, or enable Q4 from the directory once it's listed.
- Server URL:
https://api.q4.sa/mcp - Authentication: always required. Use Anthropic's hosted OAuth client metadata.
- Leave additional request headers empty. Don't paste a JWT.
- Sign in with your Q4 email and password on the Q4 authorise page.
Connect ChatGPT and Cursor
- ChatGPT (Developer Mode) uses the same URL and OAuth sign-in.
- Cursor can send a Bearer JWT from a Q4 login instead of the browser OAuth flow.
Access
A Q4 platform subscription includes website and MCP access. You can also subscribe to MCP only from the connector sign-in page, billed through StreamPay. MCP-only accounts can't use the q4.sa dashboard.
Contact contact@q4.sa for help with entitlements.
Tools
Recommended loop: numbers from q4_get_financials (and q4_compute for anything derived), explanations from q4_search, then q4_get_document or q4_get_earnings_call to read more. Every result carries a citation to quote.
| Tool | What it does |
|---|---|
q4_get_company | Resolves a Tadawul company by ID, symbol or name, and lists its filings and earnings calls. Use it first. |
q4_get_financials | Verified figures from the filings: one printed statement cell each, with its exact period, the value as printed, the declared scale, a ready-to-quote value and a citation to the cell. Reports which requested figures are found, derivable or missing. |
q4_compute | Margins, growth and derived quarters computed from q4_get_financials figures, with checks for matching company, currency and period. |
q4_search | Ranked passages from filings, reports and earnings call transcripts, with citations. Use it for explanations and context; use q4_get_financials for numbers. |
q4_get_document | Filing metadata and optional page or query excerpts. Doesn't return file bytes. |
q4_get_earnings_call | Summary, insights, and speaker and timestamp passages for a catalogued call. |
Sourced results include citation fields such as company, document, page, section, time range, quote, and a Q4 app path when available.
Security and limits
- Every tool call needs a valid subscriber token.
- Rate limit: 60 authenticated requests per user per minute.
- Tool timeout: 30 seconds.
- Internal errors are sanitised. Database credentials and file paths are never exposed.
- Q4 doesn't currently offer enterprise managed SSO or per-organisation document access controls.
Privacy and support
Email contact@q4.sa. The connector's privacy practices are at q4.sa/mcp/privacy.