integrations

Create a Plaid sandbox public token (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
POST /financial-data/sandbox/public_token/create
Access token

Developer tool: asks the Plaid sandbox for a public token (what Plaid Link hands back after someone connects a bank) for a test institution and set of products. Returns 400 unless the server is pointed at the Plaid sandbox.

application/json

Body

  • institutionId string

    Plaid institution ID to simulate. Defaults to ins_109508 (First Platypus Bank).

    Default value is ins_109508.

  • initialProducts array[string]

    Plaid products to enable on the simulated Item. Defaults to [transactions, liabilities, investments, statements].

    Values are assets, auth, beacon, employment, identity, income_verification, identity_verification, investments, liabilities, payment_initiation, standing_orders, signal, statements, transactions, transfer, cra_base_report, cra_income_insights, cra_cashflow_insights, cra_lend_score, cra_partner_insights, cra_network_insights, cra_monitoring, layer, or protect_linked_bank. Default value is ["transactions", "liabilities", "investments", "statements"].

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • publicToken string Required

        Temporary public_token to use with the exchange endpoint.

      • requestId string Required

        Request identifier for debugging and support.

    • statusCode number Required
    • timestamp string(date-time) Required
POST /financial-data/sandbox/public_token/create 
curl \
 --request POST 'http://api.example.com/financial-data/sandbox/public_token/create' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "institutionId": "ins_109508",
  "initialProducts": [
    "transactions",
    "liabilities",
    "investments",
    "statements"
  ]
}'
Request examples 
{
  "institutionId": "ins_109508",
  "initialProducts": [
    "transactions",
    "liabilities",
    "investments",
    "statements"
  ]
}
Response examples (201) 
{
  "data": {
    "publicToken": "string",
    "requestId": "string"
  },
  "statusCode": 201,
  "timestamp": "2026-01-15T10:15:00.000Z"
}