Metadata-Version: 2.4
Name: api-mapper-client
Version: 1.0.0
Summary: Client SDK for the CodedProjects AI ApiMapper Runtime
Project-URL: Homepage, https://apimapper.ai
Author: Coded Projects
License-Expression: MIT
License-File: LICENSE
Keywords: ai,apimapper,client,llm,mcp,python,sdk,tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27.0
Provides-Extra: all
Requires-Dist: langchain-core>=0.3.0; extra == 'all'
Requires-Dist: langgraph>=0.2.0; extra == 'all'
Requires-Dist: pydantic>=2.0.0; extra == 'all'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.3.0; extra == 'langchain'
Requires-Dist: pydantic>=2.0.0; extra == 'langchain'
Provides-Extra: langgraph
Requires-Dist: langchain-core>=0.3.0; extra == 'langgraph'
Requires-Dist: langgraph>=0.2.0; extra == 'langgraph'
Requires-Dist: pydantic>=2.0.0; extra == 'langgraph'
Description-Content-Type: text/markdown

# api-mapper-client

Python SDK for discovering and invoking AI ApiMapper Runtime tools from Python applications and agents.

## Install

```bash
pip install api-mapper-client
```

Optional integrations:

```bash
pip install "api-mapper-client[langchain]"
pip install "api-mapper-client[langgraph]"
pip install "api-mapper-client[all]"
```

## What it provides

- runtime tool discovery,
- runtime system prompt loading,
- tool invocation over MCP-compatible HTTP endpoints,
- API key, delegated bearer token, and OAuth2 client credentials authentication helpers,
- optional LangChain and LangGraph integration helpers.

## Quick start

```python
import uuid

from api_mapper_client import ApiMapperClient, ApiMapperClientOptions
from api_mapper_client.auth.api_key import ApiKeyCredentialProvider

client = ApiMapperClient(
    ApiMapperClientOptions(
        base_url="https://runtime.example.com",
        tenant_id=uuid.UUID("11111111-1111-1111-1111-111111111111"),
        client_id="my-ai-client",
        credentials=ApiKeyCredentialProvider("replace-with-your-api-key"),
    )
)

tools = await client.get_tools()
print([tool.name for tool in tools])
```

## License

MIT
