QuantJourney Agent Integrations

Public discovery contracts and minimal client examples for the QuantJourney Agent Fabric. The production service is available at 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
• Bounded-query OpenAPI
• Agent instructions
• Query catalogue
• Pricing and payment modes
• Current release

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.

./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:

The registry manifest is in 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 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.