agentfiles-mcp

MCP (Model Context Protocol) server for AgentFiles — gives AI agents tools to store, retrieve, and share artifacts.

Usage with Claude Code

The easiest way to set up is via the CLI:

npx agentfiles-cli connect claude_code --display-name "my-agent"

This automatically configures Claude Code's MCP settings.

Manual Configuration

Add to ~/.claude.json:

{
  "mcpServers": {
    "agentfiles": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "agentfiles-mcp"],
      "env": {
        "ATTACH_API_URL": "https://agentfiles.io",
        "ATTACH_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

• artifact_publish — Create or update an artifact
• artifact_get — Retrieve an artifact by ID
• artifact_get_latest — Get the most recent artifact in a namespace
• artifact_search — Search artifacts by query
• artifact_list_recent — List recent artifacts
• artifact_diff — Compare two versions of an artifact
• artifact_share — Create a share link
• namespace_list — List available namespaces
• git_import — Import a file from a git repository
• git_sync — Sync an artifact with its git source

Environment Variables

• ATTACH_API_KEY (required) — Your AgentFiles API key
• ATTACH_API_URL (optional) — API URL (default: http://localhost:3000)

Learn More

Website: https://agentfiles.io