agentfiles-mcp
v0.1.4
Published
MCP server for AgentFiles — gives AI agents file sharing tools
Maintainers
Readme
agentfiles-mcp
MCP server for AgentFiles — gives AI agents artifact storage, sharing, and handoff tools.
Quick start
Claude Code & Codex (auto-configured via stdio):
npx agentfiles-cli@latest setupChatGPT & remote clients (HTTP transport):
npx -y --package agentfiles-mcp@latest agentfiles-mcp-http --port 8787Or use the hosted endpoint at https://mcp.agentfiles.io/mcp with Authorization: Bearer <your API key>.
Get your API key
agentfiles config --showOr read ~/.attach/config.json directly.
Tools
| Tool | Description |
|------|-------------|
| artifact_publish | Create or update an artifact (also carries handoff metadata) |
| artifact_get | Get one artifact by ID |
| artifact_get_latest | Get the most recently updated artifact |
| artifact_search | Search artifacts by query string |
| artifact_list_recent | List recent artifacts |
| artifact_diff | Diff two versions of an artifact |
| artifact_share | Create a share link |
| namespace_list | List available namespaces |
| git_import | Import a file from GitHub/GitLab/Bitbucket |
| git_sync | Sync a git-imported artifact to its latest upstream content |
HTTP server options
| Flag / Env | Default | Description |
|---|---|---|
| --port / AGENTFILES_MCP_PORT | 8787 | Bind port |
| --host / AGENTFILES_MCP_HOST | 127.0.0.1 | Bind host |
| --path / AGENTFILES_MCP_PATH | /mcp | MCP route path |
Auth: every request to /mcp must include Authorization: Bearer <ATTACH_API_KEY>. The /health endpoint is unauthenticated.
