Developer docs · MCP

Connect Claude
or Cursor to Ysaere.

Remote Streamable HTTP MCP for Company Intelligence, Market Intelligence, Angel / Angel Deep, Due Diligence, and Security Assessment. Start with free check_balance, then Angel (50 credits) or CI. Prepaid credits on your Ysaere account.

Create a free account Open setup wizard (signed in)
Streamable HTTP OAuth 2.1 + PKCE API key fallback Traceable outputs
Endpoint

Server URL

Use this URL in Claude Connectors, Cursor MCP config, or MCP Inspector:

MCP URL
https://mcp.ysaere.com/mcp
Transport
streamable-http
Health
https://mcp.ysaere.com/health
Browser: status page · automated probes: JSON ok
Authentication

OAuth (Claude Directory and custom connectors)

Preferred for Claude. User consent via Ysaere sign-in. No Dynamic Client Registration.

Client ID
claude.ai
Client secret
(none: public PKCE client)
Authorization server
https://api.ysaere.com

API key (Cursor / Inspector)

Create an MCP-enabled production key in the app (Developer → MCP Server), then send Authorization: Bearer ysa_prod_…. Sandbox keys are rejected for MCP.

Quick start

Three steps

  1. Sign up at app.ysaere.com. New accounts receive free prepaid credits.
  2. Connect Claude to https://mcp.ysaere.com/mcp (OAuth), or paste a Cursor config from the signed-in wizard.
  3. Try it: check_balance → estimate_credits → Angel or CI → wait_for_report → verify_provenance.

Webhooks (REST companion)

MCP tools poll with wait_for_report. For backends that prefer push, register POST /v1/webhooks with event report.completed (HMAC-signed; SSRF-validated URL). See Builders → Examples.

Example prompts

Try these in Claude

Run company intelligence on Stripe and summarize the executive verdict in three bullets.

Run Angel Deep on Acme Startup and tell me whether you’d take a pre-seed meeting. Cite traction signals.

Check my Ysaere credit balance, then check status of my latest report.

Capabilities

What you can do

Check your balance, estimate cost, then start a research run. Ask Claude to wait until the report is ready, then verify the provenance receipt (integrity — not a claim that every fact is verified truth).

Balance · Estimate cost · Report status · Wait for report · Verify provenancecheck_balance · estimate_credits · check_report_status · wait_for_report · verify_provenanceFree
Company Intelligencecompany_intelligence · competitive_intelligence100 cr
Market Intelligencemarket_intelligence150 cr
Angel Intelligence · Angel Deepangel_intelligence · angel_deep_intelligence50 / 90 cr
Due Diligencedue_diligence200 cr
Security Assessmentsecurity_assessment75 cr

Tool names above are what Claude / Cursor call. HTTP API: api.ysaere.com/v1/openapi.json · Examples: ysaere.com/builders/examples/

Requirements and legal

Account, credits, disclosure

Signed-in users: copy Cursor JSON and manage keys at app.ysaere.com/developer/mcp.

Ready to connect.

Create an account, connect Claude or Cursor, then run your first Angel or Company Intelligence report from chat.

Start free Setup wizard