Back to the catalog

QuantJourney API MCP

Broad, OAuth-protected provider and financial-domain API tools for research agents.

Open source Repository Open in the app JSON README (API)

About

Broad, OAuth-protected provider and financial-domain API tools for research agents.

Details

Kind
MCP servers
Topic
Security & identity
Publisher
quantjourneyorg
Origin
official
Category
ferramentas
Transport
http
Version
2.0.0
Stars
1
Last push
2026-08-31T05:54:02Z
Repository state
ativo
License
Apache-2.0
Added
2026-08-31 06:00:07
Updated
2026-08-31 06:00:07
Origin id
io.github.QuantJourneyOrg/qj-api-mcp

README

# QuantJourney Agent Integrations

Public discovery contracts and minimal client examples for the QuantJourney
Agent Fabric. The production service is available at
[`agents.quantjourney.cloud`](https://agents.quantjourney.cloud/).

This repository is intentionally **not** the Agent Fabric server source. It
contains only material required to discover and integrate with the public
machine interfaces. Backend implementation, deployment configuration,
credentials, operational data, and private architecture remain in private
repositories.

## Public machine contracts

- [Agent Card](https://agents.quantjourney.cloud/.well-known/agent-card.json)
- [Bounded-query OpenAPI](https://agents.quantjourney.cloud/openapi.json)
- [Agent instructions](https://agents.quantjourney.cloud/llms.txt)
- [Query catalogue](https://agents.quantjourney.cloud/v1/catalog)
- [Pricing and payment modes](https://agents.quantjourney.cloud/v1/pricing)
- [Current release](https://agents.quantjourney.cloud/v1/releases/current)

Generic A2A task delegation is currently disabled. Use the bounded query
operations published in OpenAPI. Each operation declares whether it is free or
x402-paid; discovery and OAuth registration are free.

## Minimal OAuth query

The examples create one short-lived OAuth client with only `agents:query`,
obtain a 15-minute bearer token, call the free bounded company snapshot, and
deactivate the client in a `finally`/`trap` cleanup.

```bash
./examples/curl/oauth-query.sh AAPL
python3 examples/python/query.py AAPL
```

The shell example requires `curl` and `jq`. Neither example writes the client
secret or access token to disk. Production integrations should register one
durable client per workload, store its secret in a secret manager, rotate it,
and avoid registering a new client for every query.

## Remote MCP server

QuantJourney publishes the OAuth-protected QJ API MCP as a remote Streamable
HTTP server:

| Server | Remote endpoint | Purpose |
| --- | --- | --- |
| QuantJourney API MCP | `https://api.quantjourney.cloud/mcp` | Provider and financial-domain API tools for research agents. |

The registry manifest is in [`registry/`](registry/). OAuth metadata is
discovered from the protected resource; no QuantJourney service credential is
embedded in this repository.

## Security

Do not commit client secrets, bearer tokens, payment signatures, prompts, or
query results. See [SECURITY.md](SECURITY.md) for private vulnerability
reporting guidance.

## License

The public integration examples and registry metadata in this repository are
licensed under Apache License 2.0. This license does not grant access to, or
rights in, QuantJourney data, commercial services, private source code, or
third-party datasets.

More