Phiacta

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