RESOURCES / MCP

Connect FLINTover MCP

Any MCP client can authenticate with OTP, issue an owned Agent Passport at mint, and verify agent authority before value moves. No API key and no integration code.

Endpoint

https://flint.network/mcp

Transport

Streamable HTTP

Auth

OTP session

Why

Know Your Agent travels across boundaries.

Agents are already transacting across organizational boundaries. The live Cloudflare and Stripe agent protocol lets an agent open accounts and spend on its own, with a monthly cap as the only guardrail. Inside one organization, identity is solved: SPIFFE issues workload identities, A2A signs agent cards, your platform governs its own agents. None of that travels across the boundary.

FLINT is the Know Your Agent layer that does. An agent mints a portable Agent Passport and runs transaction-time verification, accepted where the issuer is not a party to the deal. The passport is the agent's portable identity; the verification record is the signed evidence a merchant keeps. FLINT is rail-neutral: payment providers move value, FLINT verifies the agent before it moves.

Connect

Add the remote MCP endpoint.

Endpoint
https://flint.network/mcp
Transport
Streamable HTTP
Authentication
OTP session, then owned mint

mcp config

{
  "mcpServers": {
    "flint": {
      "type": "streamable-http",
      "url": "https://flint.network/mcp"
    }
  }
}

In Claude Desktop, add it as a custom remote connector with that URL. On connect, the server returns instructions pointing the agent to authenticate with OTP, then mint an owned passport.

Plugin

Install the plugin.

The fastest path. One install gives you the FLINT connector and the skill that runs the verify-before-pay loop, so Claude knows when to verify, not just how. It works in Cowork, Claude.ai, and Claude Code.

Cowork and Claude.ai

Open Settings, then Plugins, then Add marketplace. Choose Add from a repository and paste https://github.com/thefraudfather/flint-plugin. Install FLINT Cross-Domain Agent Passport.

Claude Code

plugin commands

/plugin marketplace add thefraudfather/flint-plugin
/plugin install flint@flint-network

Updates sync automatically from the repository.

First mint

Issue your first passport.

Authenticate first, then mint owned. The only required identity field is name.

tool call

auth_request_otp
{ "email": "owner@example.com" }

auth_verify_otp
{ "email": "owner@example.com", "code": "123456" }

issue_agent_passport
{
  "session_token": "session_...",
  "agent": { "agent_name": "Invoice Bot" }
}

abbreviated response

{
  "passport_id": "kya_01J7QJ3VQV4X30B6XEXBHHDM",
  "passport_url": "https://flint.network/passport/kya_01J7QJ3VQV4X30B6XEXBHHDM",
  "owned": true,
  "signature_valid": true
}

Pass session_token so ownership attaches at mint. Omit it only for an anonymous mint; that path returns a claim_url for a human to attach later. Controller, wallet, attestations, and the spending mandate are optional and updatable later without reissuing.

Stack fit

Works with your stack.

FLINT does not replace your identity provider, it composes with it. Pass your agent's SPIFFE SVID or a signed agent card as the runtime claim, and FLINT verifies authority and behavior on top of the identity you already issue. SPIFFE is the driver's license inside your organization. FLINT is the passport for when your agent leaves it.

Verify loop

  1. Issue passport once.
  2. Before any payment, paid API, checkout, or stablecoin transfer, call issue_authorization_record.
  3. After transaction, your authenticated merchant backend posts the outcome to /api/outcomes.

authorization record

issue_authorization_record
{
  "transaction": { "amount_display": "847.00 USDC", "merchant_reference": "order_847" },
  "agent_claim": { "spiffe_svid": "spiffe://acme.example/ns/agents/sa/invoice-bot" }
}

The call returns a four-state verdict, allow, step-up, review, or block, plus a compact JWS verifiable against flint.network/.well-known/jwks.json.

Reference

Tool reference.

Authenticate

auth_request_otp

Emails a one-time sign-in code. First step in the agent-native mint flow.

write

auth_verify_otp

Exchanges the OTP for a session_token used to mint an owned passport.

write

Issue and manage

issue_agent_passport

Issues a hybrid-signed Agent Passport. Pass session_token to own it at mint; omit it only for anonymous mint with a claim_url.

write

get_agent_passport

Resolves identity, mandate, status, and public URL for an existing passport.

read

update_agent_mandate

Updates mutable mandate config without reissuing or re-signing the passport.

write

Verify

issue_authorization_record

Checks agent authority for a transaction and returns a signed compact JWS record.

write

verify_agent_authority

Verifies and decodes a signed verification record against the public JWKS.

read

Reputation

lookup_agent_reputation

Returns partner-safe aggregate reputation for a FLINT agent id.

read

Scout

run_flint_scout

Runs a $0.01 pre-transaction scan. Default is per-call x402; prepaid credits apply only with session_token after a credits top-up. Payment is not authorization.

write

scout_credits_topup

Buys FLINT Scout scan credits in bulk: one $1.00 x402 payment buys 100 credits, matching the $0.01 per-scan price without signing every run_flint_scout call. Requires session_token so credits land on that account.

write

scout_credits_balance

Checks a FLINT account's prepaid Scout credit balance before relying on it for run_flint_scout. Requires session_token. Returns balance, lifetime purchased_total and used_total, and a recent ledger.

read

report_scout_outcome

Reports what happened after a run_flint_scout scan: executed, held, cancelled, or executed despite a BLOCK verdict. Authorize with session_token when the account owns the passport, or with caller_binding_token from the scan when acting anonymously.

write

Integrator helpers

create_flint_trust_manifest

Generates a /.well-known/flint.json trust manifest for an integration.

read

generate_authorization_scope

Builds a bounded delegated authorization scope for a future record.

read

validate_agent_commerce_readiness

Checks whether an architecture is ready for agent commerce controls.

read

Privacy

Cost and privacy.

Issuing an Agent Passport is free. Passports are signed and publicly resolvable by design, so counterparties can verify the credential without opening an account. FLINT uses the verification data you submit to train and improve its own fraud-detection models, the protective intelligence that defends your agent against takeover, diversion, and impersonation. FLINT does not sell your data, does not share raw identifiers, and does not use it to train third-party or general-purpose models. Runtime and reputation identifiers are partner-scoped so cross-domain trust never becomes cross-domain tracking. Read the privacy policy.

Scout credits are prepaid scan payment, not authorization. Use run_flint_scout for a $0.01 pre-transaction scan. See FLINT Scout for scan details.

Support

Troubleshooting and FAQ.

Do I need an account or key?

An OTP session is the recommended path so the passport is owned at mint. Anonymous mint still works without a signup. No API key is required.

The connection fails.

Confirm the URL is https://flint.network/mcp, the type is streamable-http, and the request is over HTTPS. The server is reached over the public internet.

I am getting a 429.

Requests are rate-limited to 60 per minute per IP. Wait one minute and retry.

My passport URL will not resolve.

Passports are public and resolve immediately. Recheck the passport_id, which begins with kya_.

How do I attach a passport to an account?

Authenticate first and pass session_token on issue_agent_passport so ownership attaches at mint. Use claim_url only if you minted anonymously.

How do I change spend limits?

Call update_agent_mandate. The mandate is mutable and is not part of the passport signature, so no reissue is needed.

How do I verify a record someone sent me?

Call verify_agent_authority, or verify the compact JWS against https://flint.network/.well-known/jwks.json.

I see an Origin error.

The server validates Origin and Host. Server-to-server agents with no Origin header are allowed. Browser clients must originate from flint.network.

Start with the credential

Issue, verify, and keep signed proof before value moves.