clearcomply · Python SDK + CLI + MCP bridge

The official Python toolkit for ClearComply — an agent-ready IP compliance API covering 15 official patent and trademark sources (USPTO, EUIPO, WIPO, EPO, Google Patents, KIPRIS and more).

pip install clearcomply
# or, for the CLI globally:
pipx install clearcomply

Quick start

from clearcomply import ClearComply

pc = ClearComply()  # reads CLEARCOMPLY_API_KEY, or auto-onboards a 7-day trial key

# Patent search
result = pc.search("wireless earphones", entity_type="patent",
                   sources=["google_patents", "wipo_patentscope"])
print(result.markdown)            # LLM-ready markdown
print(result.source_results)      # structured records

# Trademark search
pc.search("nike", entity_type="trademark", sources=["euipo", "uspto_tm"])

# Risk analysis
pc.analyze("nike", entity_type="trademark", prompt="Conflict risk summary")

# Logo / image search
with open("logo.png", "rb") as fp:
    pc.search_image(fp, entity_type="trademark")

CLI

clearcomply auth login                       # auto-onboard a trial key
clearcomply search "nike" --type trademark   # search command
clearcomply analyze "wireless earphones"     # search + AI risk summary
clearcomply sources health                   # platform availability
clearcomply mcp serve                        # stdio MCP bridge for Claude Desktop
clearcomply skill install --target claude-code   # writes Skill into agent dir

Skill install targets

skill install --target supports:

MCP

// Claude Desktop / Cursor / VS Code (.cursor/mcp.json):
{
  "mcpServers": {
    "clearcomply": {
      "url": "https://your-host/mcp",
      "transport": "streamable-http",
      "headers": {"Authorization": "Bearer cc_live_..."}
    }
  }
}

For clients that only support stdio MCP, run clearcomply mcp serve and point them at the spawned process.