Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Connect an MCP client

FiveSocket exposes one remote Model Context Protocol endpoint:
https://api.fivesocket.com/mcp
Paste that URL into a client that supports custom remote MCP connections. The client discovers FiveSocket's OAuth authorization server from the protected-resource metadata, registers as a public client, and opens FiveSocket sign-in and consent. FiveSocket requires S256 PKCE and gives the client only short-lived MCP tokens for the scopes you approve. Do not create or paste a REST API key into the MCP client.
Custom remote MCP connections can depend on the client plan and workspace policy. FiveSocket implements standard OAuth discovery; the client decides whether custom connections are available to its user.

Before connecting

  1. Create and verify your account
    Start from FiveSocket pricing, choose a plan, and create your account. Enter the eight-digit email code yourself. An assistant does not need access to your mailbox.
  2. Activate the trial
    Complete the card-required Stripe checkout and any bank or 3DS approval yourself. FiveSocket waits for Stripe's signed subscription event before granting access; the checkout redirect alone does not activate a workspace.
  3. Link MT5 safely
    Use the Accounts page in the FiveSocket control surface to verify the exact MT5 server and link the account. Broker credentials go directly from the browser to the FiveSocket gateway over TLS. Never paste an MT5 login or password into an assistant conversation or MCP tool argument.

Choose permission

FiveSocket presents the exact requested scopes during OAuth consent:
ChoiceScopesCapability
Read onlyaccounts:read, data:readList linked accounts and read live account data
Read and tradeRead scopes plus trading:executeUse trading tools within the account's separate execution policy
Trading permission does not bypass the per-account symbol and maximum-volume policy. Grant it only when the client needs to act, not merely analyze. MCP clients cannot link accounts, change broker credentials, verify arbitrary server names, or use REST routes.

Connect

  1. Open the client's custom connection or connector settings.
  2. Add a remote MCP server using https://api.fivesocket.com/mcp.
  3. Complete FiveSocket sign-in in the browser window the client opens.
  4. Review the client name and exact scopes, then approve or cancel.
  5. Return to the client and ask it to list your FiveSocket accounts before making a live read.
The OAuth protected-resource metadata is available at:
https://api.fivesocket.com/.well-known/oauth-protected-resource/mcp
The authorization-server address is discovered from that metadata. Do not hard-code or guess an authorization URL.

Revoke

Open MCP connections in the FiveSocket control surface. Each authorized client shows its name, scopes, authorization time, and last use. Workspace owners and administrators can revoke a connection. Revocation applies to its next request, invalidates refresh authority, and does not disable the linked MT5 account or unrelated REST API keys. Access tokens are short-lived and refresh tokens rotate automatically.

Long-running and ambiguous operations

  • A new or cold MT5 session can report that the account is warming. Let the client honor the bounded retry guidance.
  • History reads can require additional bounded acquisition before coverage converges.
  • A trading command can return a pollable commit_unknown state after a lost broker response. Do not submit a replacement command. Poll the original command until it becomes terminal, and manually reconcile an unresolved result.
  • Keep the request identifier from a failed tool result when contacting support.
FiveSocket reports live MT5 source data and clearly labels application-derived values. An assistant's interpretation is not broker-guaranteed truth or investment advice. Never paste MT5 credentials, API keys, authorization codes, access tokens, or refresh tokens into model instructions or chat messages.