Connect an AI agent
Authorize an MCP client so an agent can read your portfolio and record evidence and decisions on your behalf. Run this once per client.
Goal
One authorized MCP client that can read your portfolio and write evidence and decisions, scoped to your organization.
Steps
Point the client at the MCP endpoint
Agimon exposes an MCP HTTP streamable endpoint at /api/v1/mcp, with a versioned form at /api/v1/mcp/:version. Give your client that URL. Clients that support discovery will find the authorization server through the standard .well-known metadata rather than needing it configured by hand.
Let the client register itself
Authorization runs on OAuth with OIDC discovery. Clients that support dynamic client registration, including ChatGPT, register themselves and are recorded as an oauth_client. You do not need to create credentials manually for those.
Sign in and grant consent
The client sends you to Agimon to sign in and approve the connection. Your approval is recorded as an oauth_consent, and the client receives an oauth_access_token with an oauth_refresh_token so the session survives without asking you again each time.
Confirm the agent can read
Ask the agent to list your portfolio. A successful read confirms the token works and that the agent is pointed at the right organization. Access is organization-scoped, so an agent authorized for one organization cannot see another.
Let it write
Once reads work, the agent can record weekly evidence and decisions through the MCP write tools. Every write tool requires an idempotencyKey, so a retried call updates or is ignored rather than duplicating a snapshot or a decision.
Review what the agent recorded
Read the portfolio and the decision log after the first agent-driven week. Everything the agent wrote is in the ledger with its reasoning, and anything you disagree with is superseded rather than deleted.
Worth knowing
Writes are MCP only
There is no HTTP write route. The REST surface is read-only, so an authorized MCP client is how anything gets recorded.
The agent operates, you steer
An agent can record decisions, and each one applies immediately. You keep the seat by reading the ledger and superseding what you disagree with, not by approving each call before it lands.