Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Repository files navigation

Blockworks plugin for Claude

Crypto research and market data from Blockworks, inside Claude. The plugin connects Claude to the Blockworks MCP server and adds a skill, a command and an agent that teach Claude how to use it well.

What it includes

  • MCP server (.mcp.json): connects to the hosted Blockworks MCP server at https://mcp.blockworks.com/mcp over HTTP. The plugin contains only this address. It does not contain or run any server code on your machine.
  • Skill crypto-research: tells Claude which tool answers which kind of question.
  • Command /blockworks:research <topic>: writes a short, cited research brief on an asset, protocol or topic.
  • Agent crypto-analyst: handles multi-part research questions that need numbers and sources.

Tools

The data tools are read-only. They do not trade, move funds or change any data. The one tool that writes, submit_feedback, sends a problem report to Blockworks and changes nothing else.

Tool What it does
search_documents Finds research, news, governance, diligence and transcript documents
tabular_catalog Lists row-and-column datasets and their fields
tabular_data Reads filtered, sorted rows from one dataset
timeseries_catalog Lists time-series datasets, granularities and metrics
timeseries_data Reads metric values over a time window
monitoring_categories Lists the category and subcategory slugs the monitoring filters take
monitoring_developments Reads individual industry developments from Blockworks' monitoring coverage, with their source documents
monitoring_events Reads events: related developments grouped into a story over time
monitoring_views Lists the saved monitoring views the user can see, and their recent matches
watchlists Lists the user's watchlists
watchlist_assets Reads the assets on one watchlist
submit_feedback Sends a report about a tool error, wrong or missing data, or a missing capability to Blockworks

Sign in

You need a Blockworks account to use the plugin. Create one at app.blockworks.com.

The server uses OAuth.

  1. The first time Claude calls a Blockworks tool, Claude opens a Blockworks sign-in page in your browser.
  2. Sign in with your Blockworks account. If you prefer, enter a Blockworks API key on that page instead. Create a key at app.blockworks.com/account/api.
  3. The page sends you back to Claude. Claude then sends a bearer token on each request to the server.

The server gives Claude a token that lasts 30 days. If you sign out everywhere or revoke the API key you used, the next tool call fails and Claude asks you to sign in again.

Known limit when signing in with an API key: the sign-in page does not check the key. If you enter a wrong key, sign-in still completes. The error appears at the first tool call as UNAUTHORIZED: API key invalid or expired. To fix it, disconnect the Blockworks server in Claude, then sign in again.

Access tiers

What you can read depends on the entitlements of your Blockworks account, or of the API key if you signed in with one.

  • search_documents needs an Enterprise account with the ai_toolkit_permission API permission. It allows 30 requests per minute for each user.
  • Monitoring: the four monitoring_* tools read the Blockworks monitoring product, which an account is entitled to separately. Without that entitlement they return FORBIDDEN.
  • Watchlists: watchlists and watchlist_assets read only the signed-in user's own and team-shared watchlists.
  • Datasets: each dataset in tabular_catalog and timeseries_catalog shows an access tier. A public dataset needs no entitlement. The unpaid, paid and permissive tiers need a key with the matching entitlement. A permissive dataset also names the permission it needs.

The catalogs list only the datasets that Blockworks publishes to its public API.

Example prompts

  • "What happened with EigenLayer governance in August 2026? Cite your sources."
  • "Show the top 10 assets by market cap today."
  • "Show the daily price of ETH for the last 90 days."
  • "How did Uniswap fees change from Q1 2026 to Q2 2026?"
  • "What happened in DeFi governance this week? Use the monitoring tools and cite the sources."
  • "How did the assets on my watchlist do over the last 30 days?"
  • "/blockworks:research Hyperliquid"

Troubleshooting

Error Cause Fix
UNAUTHORIZED: API key invalid or expired The key is wrong, revoked or expired, or the session ended Disconnect the server in Claude and sign in again
FORBIDDEN: this endpoint requires an Enterprise account with the ai_toolkit_permission API permission search_documents needs Enterprise access Upgrade your plan, or use the dataset tools only
FORBIDDEN: your subscription tier does not grant access to this dataset The dataset's access tier is above your key's entitlements Pick a dataset your tier allows. Check the tier in the catalog.
RATE_LIMITED: ... Too many requests in a short time Wait, then try again
search_documents returns old documents The query has no dates Put concrete dates in the question, such as "in August 2026"
FORBIDDEN from a monitoring_* tool The account is not entitled to the monitoring product Use the other tools; contact Blockworks to add monitoring to the account

Data and privacy

The plugin sends your questions and tool arguments only to the Blockworks MCP server at mcp.blockworks.com. It runs no local code and no hooks. Your sign-in credentials go only to Blockworks. See the Blockworks Terms and Privacy Policy.

Install

After the listing goes live, add the plugin from the Claude plugin directory.

To test a local copy in Claude Code, clone this repository and start Claude Code with the plugin folder:

claude --plugin-dir ./blockworks-claude-plugin

License

MIT. See LICENSE.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors