mcp

This repository provides the decentralised.art MCP server and its decentralised-art-mcp CLI. It exposes format-agnostic protocol operations under the core.* namespace.

Agents can read the full decentralised.art documentation in markdown, starting from https://decentralised.art/llms.txt. The MCP bundles the complete, unabridged llms-full.txt as well as individual platform pages: agents can read them through MCP resources or core.documentation, without visiting the website. Start with getting-started for account onboarding, then read llms-full for system-wide concepts and good practices before designing operations.

If you are a user of this repo, the important question is simple:

• install it
• run it as an MCP server
• register it in your MCP-capable host
• use it

What users get

When the MCP server is running, an MCP host can use tools such as:

• core.documentation
• core.create_account
• core.connector_exists
• core.get_connector
• core.get_transformation
• core.get_condition
• core.transformation_exists
• core.condition_exists
• core.get_feed_page
• core.get_feed_stream_replay
• core.list_formats
• core.get_format
• core.get_account
• core.get_nonce
• core.create_connector
• core.create_transformation
• core.create_condition
• core.simulate_connector
• core.prepare_publication
• core.publish_entity
• core.confirm_publication
• core.execute_connector
• core.ensure_preflight
• core.build_parent_connector

It also exposes these MCP resources (URI prefix decentralised-art://resource/):

• core.getting-started
• core.primer
• core.docs.llms-full — complete llms-full.txt, preserved verbatim
• core.docs.tutorial
• core.docs.mcp
• core.docs.sdk
• core.docs.api-reference
• core.docs.about
• core.docs.roadmap

Hosts that expose only tools can read the identical text through core.documentation. It defaults to getting-started; pass topic to select a guide. Long guides return next_start_line for continuation. To read the full platform documentation through a tool, call core.documentation with {"topic":"llms-full"} and follow next_start_line until it is null. Resource-capable hosts can read the complete text at decentralised-art://resource/core.docs.llms-full in one request. Bundling makes the text discoverable; the host still has to load it into the agent’s context.

Fresh accounts without user-supplied keys

A new signing identity does not require the user to supply an existing private key. On macOS/Linux, an agent can call core.create_account with a stable ID:

{"account_id":"draft_owner"}

The server generates and persists the Ethereum key locally, returning only account_id, address and created. Retrying the same ID reuses that identity. Pass account_id to draft creation, preflight and publication tools. No gas, funds or API request is needed to create an account; drafts also spend no gas.