Identity

GET /v1/me

Returns the authenticated user's identity and account tier. This endpoint is called automatically by the MCP server on startup to enable buyer CRM tools — you don't need to call it manually.

Parameters

This endpoint takes no parameters. Authentication is via your API key in the X-API-Key header.

Example Request

curl -X GET "https://api.acqatlas.com/v1/me" \
  -H "X-API-Key: ak_live_your_key_here"

Example Response

{
  "success": true,
  "data": {
    "userId": "31ab65b0-3011-70d4-ff84-00115ce47b4d",
    "tier": "free"
  },
  "meta": {
    "request_id": "req_ddf7e19d260c9818",
    "tier": "free",
    "rate_limit_remaining": 99
  }
}

Response Fields

Field	Type	Description
userId	string	Your unique user ID (Cognito sub). Used internally to scope buyer CRM data.
tier	string	Your account tier: free, starter, pro, or enterprise.

How the MCP Server Uses This

When the MCP server starts, it automatically calls GET /v1/me with your API key. If the response is successful, the server:

1. Extracts your userId to scope all buyer CRM queries to your account
2. Registers all 12 buyer CRM tools in addition to the 8 filing tools
3. Logs your authentication status to stderr

If the call fails (invalid key, network error), only the 8 filing tools are registered. Buyer CRM tools require a verified user identity.

No manual setup needed

You never need to call this endpoint yourself or configure a user ID. Just set your ACQATLAS_API_KEY and the MCP server handles the rest.