phiacta-mcp

MCP server for interacting with the Phiacta knowledge platform.

Setup

Add to your MCP client config (Claude Code, Cursor, Codex, etc.):

{
  "mcpServers": {
    "phiacta": {
      "command": "npx",
      "args": ["-y", "phiacta-mcp@latest"],
      "env": {
        "PHIACTA_TOKEN": "<your-token>"
      }
    }
  }
}

Create an account at phiacta.com and generate a personal access token under Settings > Tokens.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | PHIACTA_API_URL | https://api.phiacta.com | Phiacta API base URL | | PHIACTA_TOKEN | | Personal access token (recommended) | | PHIACTA_USERNAME | | Username (alternative to token) | | PHIACTA_PASSWORD | | User password (alternative to token) |

Local Development

npm install
npm run build

PHIACTA_API_URL=http://localhost:8000 \
PHIACTA_TOKEN=your-token \
npm start

Or with hot reload:

PHIACTA_API_URL=http://localhost:8000 \
PHIACTA_TOKEN=your-token \
npm run dev

Available Tools

| Tool | Description | |------|-------------| | list_entries | List entries with pagination and filters | | get_entry | Get entry details with refs | | search_entries_by_tags | Find entries by tags | | get_entry_tags | Get tags for an entry | | get_entry_references | Get refs for an entry | | create_entry | Create a new knowledge entry | | create_entry_ref | Link two entries with a typed reference | | set_entry_tags | Set tags on an entry | | update_entry | Update entry metadata |