Skip to content

SDK v1.13.1

Choose a tag to compare

@github-actions github-actions released this 23 Apr 19:54
· 7 commits to main since this release

Highlights

Documentation corrections only — no behaviour changes. Fixes two places that cited "list-specific" as a valid fieldTypes value (it isn't; the correct V2 enum values are "enriched", "list", "global", and "relationship-intelligence").

Bug Fixes

  • docs/public/cli-reference.md: fieldTypes example corrected from "list-specific" to the complete valid set ("global", "list", "enriched", "relationship-intelligence").
  • affinity/models/entities.py: FieldMetadata.type inline comment corrected from "list-specific" to "list" to match the actual V2 API enum value.
  • CLAUDE.md: V2 Filter "silently ignored" section now correctly documents that companies, persons, and opportunities also reject filter= (previously only mentioned list entries).

Quick Install

SDK only:

pip install affinity-sdk

SDK + CLI:

pipx install "affinity-sdk[cli]"

MCP Server for Claude Desktop (easiest - MCPB bundle):

  1. Install CLI: pipx install "affinity-sdk[cli]"
  2. (Optional) Pre-configure API key: xaffinity config setup-key
    • If skipped, Claude Desktop will prompt for your API key during install
  3. Install xaffinity MCP in Claude Desktop (download and double-click)

Other MCP clients (Cursor, Windsurf, VS Code, etc.) require manual configuration - see MCP docs.

Full documentation | MCP Server docs