1
Get an API key
Sign in at app.blockworks.com/account/api and copy an API key.You need the key only once, during the OAuth step below. It is not stored in any config file on your machine.
2
Add the server to your client
Point your MCP client at the hosted server URL:In Claude Code, that is a single command:Every other client is a settings screen or a small JSON block. See Client setup for the exact
steps for Claude, Claude Desktop, Cursor, ChatGPT, and generic MCP clients.
3
Authenticate in the browser
The first time your client connects, it detects that the server requires authentication and opens a browser
window. Enter your Blockworks API key there to complete the OAuth flow.Your client stores the resulting OAuth credentials and reuses them on later connections, so you only do this
once per client.
If no browser window appears, check that popups are not blocked and that your client supports remote MCP
servers with OAuth 2.0. See Troubleshooting.
4
Confirm the tools are loaded
Ask your assistant:It should list the five Blockworks tools it can call:
search_documents, tabular_catalog, tabular_data,
timeseries_catalog, and timeseries_data. See the tools reference for what each one
does.If the list is empty, the connection or the OAuth step did not complete. Reconnect the server and try again.5
Run your first prompt
Try a lookup that clearly needs live data:Then something with more shape to it:Your assistant should call a Blockworks tool and answer from the returned data rather than from memory.
Where to go next
Client setup
Per-client configuration, including JSON config formats.
What to ask
Prompt patterns that get the best results.
Troubleshooting
Auth loops, invalid keys, and stale credentials.