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 startOr with hot reload:
PHIACTA_API_URL=http://localhost:8000 \
PHIACTA_TOKEN=your-token \
npm run devAvailable 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 |
