Metadata-Version: 2.4
Name: limex-mcp
Version: 0.1.1
Summary: MCP server for Limex research data access.
Author: Limex
License-Expression: MIT
Project-URL: Homepage, https://getlimex.com
Project-URL: Repository, https://github.com/Limex-HQ/limex-mcp
Project-URL: Issues, https://github.com/Limex-HQ/limex-mcp/issues
Keywords: limex,mcp,agents,research,data
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Dynamic: license-file

# Limex MCP

Public MCP server shim for Limex.

This package exposes MCP tools and forwards requests to the hosted Limex backing API. Provider
routing, billing, metering, and paid data integrations stay on the hosted
Limex service.

## Install

Create a Limex account first and generate a Limex API key from
`https://getlimex.com/account`.

Install it into Claude Code:

```bash
curl -fsSL https://raw.githubusercontent.com/Limex-HQ/limex-mcp/main/scripts/install.sh | bash
```

Claude Code config:

```json
{
  "mcpServers": {
    "limex": {
      "command": "uvx",
      "args": ["limex-mcp"],
      "env": {
        "LIMEX_API_KEY": "your_limex_api_key",
        "LIMEX_API_BASE_URL": "https://api.getlimex.com"
      }
    }
  }
}
```

## Tools

- `research(intent, target, questions=None, max_budget_cents=1000, freshness=None, constraints=None)`
- `get_usage_summary()`
- `get_billing_account()`
- `get_prices()`

## Publishing

PyPI package name: `limex-mcp`.

1. Create a PyPI project or pending trusted publisher for `limex-mcp`.
2. In PyPI, configure a GitHub trusted publisher:
   - Owner: `Limex-HQ`
   - Repository: `limex-mcp`
   - Workflow: `publish.yml`
   - Environment: `pypi`
3. In GitHub, create an environment named `pypi`. Add a required reviewer if you want a human
   approval gate before publication.
4. Bump `version` in `pyproject.toml`.
5. Create and publish a GitHub Release for a tag like `v0.1.0`.

The release workflow builds the package, runs tests and lint, then publishes to PyPI through
trusted publishing. Claude Code starts the server with `uvx limex-mcp` from the MCP config; running
that command in a terminal only prints setup guidance.
