| Name | axiomatic-mcp JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | None |
| Summary | Modular MCP servers for Axiomatic_AI |
| upload_time | 2025-08-20 17:19:57 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
mcp
axiomatic
ai
fastmcp
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Axiomatic MCP Server
MCP (Model Context Protocol) server for the Axiomatic_AI platform, built with FastMCP in Python. Provides access to Axiomatic_AI's tools via MCP.
- **FastMCP-based server**: Built on the FastMCP framework for efficient MCP implementation
- **Axiomatic API integration**: Connects to Axiomatic AI's API for various tooling
- **Simple configuration**: Easy setup with API key environment variable
## Installation
> **Important**: This will install the latest released version (see [releases](https://github.com/Axiomatic-AI/ax-mcp/releases)). To install the latest development version, see the development instructions
You can install each domain server independently based on your needs. These can be installed in many MCP clients such as cursor or claude.
**For PIC Domain:**
[](https://cursor.com/en/install-mcp?name=axiomatic-pic&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1waWMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
```json
{
"axiomatic-pic": {
"command": "uvx",
"args": ["--from", "axiomatic-mcp", "axiomatic-pic"],
"env": {
"AXIOMATIC_API_KEY": "your-api-key-here"
}
}
}
```
**For Documents:**
[](https://cursor.com/en/install-mcp?name=axiomatic-documents&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1kb2N1bWVudHMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
```json
{
"axiomatic-documents": {
"command": "uvx",
"args": ["--from", "axiomatic-mcp", "axiomatic-documents"],
"env": {
"AXIOMATIC_API_KEY": "your-api-key-here"
}
}
}
```
**For Plots:**
[](https://cursor.com/en/install-mcp?name=axiomatic-plots&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1wbG90cyIsImVudiI6eyJBWElPTUFUSUNfQVBJX0tFWSI6InlvdXItYXBpLWtleS1oZXJlIn19)
```json
{
"axiomatic-plots": {
"command": "uvx",
"args": ["--from", "axiomatic-mcp", "axiomatic-plots"],
"env": {
"AXIOMATIC_API_KEY": "your-api-key-here"
}
}
}
```
## Development
1. Clone the repository:
```bash
git clone https://github.com/axiomatic/ax-mcp.git
cd ax-mcp
```
2. Install in development mode:
```bash
make install-dev
```
3. Add servers to Cursor using Python module paths:
**For PIC Domain:**
```json
{
"axiomatic-pic": {
"command": "python",
"args": ["-m", "axiomatic_mcp.servers.pic"],
"env": {
"AXIOMATIC_API_KEY": "your-api-key-here"
}
}
}
```
**For Documents:**
```json
{
"axiomatic-documents": {
"command": "python",
"args": ["-m", "axiomatic_mcp.servers.documents"],
"env": {
"AXIOMATIC_API_KEY": "your-api-key-here"
}
}
}
```
**For Plots:**
```json
{
"axiomatic-plots": {
"command": "python",
"args": ["-m", "axiomatic_mcp.servers.plots"],
"env": {
"AXIOMATIC_API_KEY": "your-api-key-here"
}
}
}
```
### Project Structure
```
ax-mcp/
├── axiomatic_mcp/
│ ├── shared/ # Shared utilities
│ └── servers/ # Domain-specific servers
├── pyproject.toml # Python package configuration
```
### Adding a New Server
1. Create server directory:
```bash
mkdir axiomatic_mcp/servers/my_domain
```
2. Create `__init__.py`:
```python
from .server import MyDomainServer
def main():
server = MyDomainServer()
server.run()
```
2. Create `__main__.py`:
```python
from . import main
if __name__ == "__main__":
main()
```
3. Implement server in `server.py`:
```python
from fastmcp import FastMCP
mcp = FastMCP(
name="NAME",
instructions="""GIVE NICE INSTRUCTIONS""",
version="0.0.1",
)
@mcp.tool(
name="tool_name",
description="DESCRIPTION",
tags=["TAG"],
)
def my_tool():
pass
# Add more tools as needed
```
4. Add entry point to `pyproject.toml`:
```toml
[project.scripts]
axiomatic-mydomain = "axiomatic_mcp.servers.my_domain:main"
```
5. Update README.md with instructions on installing your server. You can generate the "Add to cursor" button [here](https://docs.cursor.com/en/tools/developers)
## Troubleshooting
### Server not appearing in Cursor
1. Restart Cursor after updating MCP settings
2. Check the Output panel (View → Output → MCP) for errors
3. Verify the command path is correct
### Multiple servers overwhelming the LLM
Install only the domain servers you need. Each server runs independently, so you can add/remove them as needed.
### API connection errors
1. Verify your API key is set correctly
2. Check internet connection
## Release Process
### Publishing a Release
1. Create a new release branch
1. Update version in `pyproject.toml`
1. Commit and push changes
1. Create a pull request titled "Release: YOUR FEATURE(s)". Include detailed description of what's included in the release.
1. Create a GitHub release with tag `vX.Y.Z`
1. GitHub Actions automatically publishes to PyPI
The package is available at: https://pypi.org/project/axiomatic-mcp/
Raw data
{
"_id": null,
"home_page": null,
"name": "axiomatic-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "mcp, axiomatic, ai, fastmcp",
"author": null,
"author_email": "Axiomatic Team <developers@axiomatic.ai>",
"download_url": "https://files.pythonhosted.org/packages/99/4e/053ef39cd042d67c2974740806c6ff6a2f236a29b7c0f530cde2d87a6bc5/axiomatic_mcp-0.0.2.tar.gz",
"platform": null,
"description": "# Axiomatic MCP Server\n\nMCP (Model Context Protocol) server for the Axiomatic_AI platform, built with FastMCP in Python. Provides access to Axiomatic_AI's tools via MCP.\n\n- **FastMCP-based server**: Built on the FastMCP framework for efficient MCP implementation\n- **Axiomatic API integration**: Connects to Axiomatic AI's API for various tooling\n- **Simple configuration**: Easy setup with API key environment variable\n\n## Installation\n\n> **Important**: This will install the latest released version (see [releases](https://github.com/Axiomatic-AI/ax-mcp/releases)). To install the latest development version, see the development instructions\n\nYou can install each domain server independently based on your needs. These can be installed in many MCP clients such as cursor or claude.\n\n**For PIC Domain:**\n\n[](https://cursor.com/en/install-mcp?name=axiomatic-pic&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1waWMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)\n\n```json\n{\n \"axiomatic-pic\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"axiomatic-mcp\", \"axiomatic-pic\"],\n \"env\": {\n \"AXIOMATIC_API_KEY\": \"your-api-key-here\"\n }\n }\n}\n```\n\n**For Documents:**\n\n[](https://cursor.com/en/install-mcp?name=axiomatic-documents&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1kb2N1bWVudHMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)\n\n```json\n{\n \"axiomatic-documents\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"axiomatic-mcp\", \"axiomatic-documents\"],\n \"env\": {\n \"AXIOMATIC_API_KEY\": \"your-api-key-here\"\n }\n }\n}\n```\n\n**For Plots:**\n\n[](https://cursor.com/en/install-mcp?name=axiomatic-plots&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1wbG90cyIsImVudiI6eyJBWElPTUFUSUNfQVBJX0tFWSI6InlvdXItYXBpLWtleS1oZXJlIn19)\n\n```json\n{\n \"axiomatic-plots\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"axiomatic-mcp\", \"axiomatic-plots\"],\n \"env\": {\n \"AXIOMATIC_API_KEY\": \"your-api-key-here\"\n }\n }\n}\n```\n\n## Development\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/axiomatic/ax-mcp.git\ncd ax-mcp\n```\n\n2. Install in development mode:\n\n```bash\nmake install-dev\n```\n\n3. Add servers to Cursor using Python module paths:\n\n**For PIC Domain:**\n\n```json\n{\n \"axiomatic-pic\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"axiomatic_mcp.servers.pic\"],\n \"env\": {\n \"AXIOMATIC_API_KEY\": \"your-api-key-here\"\n }\n }\n}\n```\n\n**For Documents:**\n\n```json\n{\n \"axiomatic-documents\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"axiomatic_mcp.servers.documents\"],\n \"env\": {\n \"AXIOMATIC_API_KEY\": \"your-api-key-here\"\n }\n }\n}\n```\n\n**For Plots:**\n\n```json\n{\n \"axiomatic-plots\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"axiomatic_mcp.servers.plots\"],\n \"env\": {\n \"AXIOMATIC_API_KEY\": \"your-api-key-here\"\n }\n }\n}\n```\n\n### Project Structure\n\n```\nax-mcp/\n\u251c\u2500\u2500 axiomatic_mcp/\n\u2502 \u251c\u2500\u2500 shared/ # Shared utilities\n\u2502 \u2514\u2500\u2500 servers/ # Domain-specific servers\n\u251c\u2500\u2500 pyproject.toml # Python package configuration\n```\n\n### Adding a New Server\n\n1. Create server directory:\n\n```bash\nmkdir axiomatic_mcp/servers/my_domain\n```\n\n2. Create `__init__.py`:\n\n```python\nfrom .server import MyDomainServer\n\ndef main():\n server = MyDomainServer()\n server.run()\n```\n\n2. Create `__main__.py`:\n\n```python\nfrom . import main\n\nif __name__ == \"__main__\":\n main()\n```\n\n3. Implement server in `server.py`:\n\n```python\nfrom fastmcp import FastMCP\n\nmcp = FastMCP(\n name=\"NAME\",\n instructions=\"\"\"GIVE NICE INSTRUCTIONS\"\"\",\n version=\"0.0.1\",\n)\n\n@mcp.tool(\n name=\"tool_name\",\n description=\"DESCRIPTION\",\n tags=[\"TAG\"],\n)\ndef my_tool():\n pass\n\n# Add more tools as needed\n```\n\n4. Add entry point to `pyproject.toml`:\n\n```toml\n[project.scripts]\naxiomatic-mydomain = \"axiomatic_mcp.servers.my_domain:main\"\n```\n\n5. Update README.md with instructions on installing your server. You can generate the \"Add to cursor\" button [here](https://docs.cursor.com/en/tools/developers)\n\n## Troubleshooting\n\n### Server not appearing in Cursor\n\n1. Restart Cursor after updating MCP settings\n2. Check the Output panel (View \u2192 Output \u2192 MCP) for errors\n3. Verify the command path is correct\n\n### Multiple servers overwhelming the LLM\n\nInstall only the domain servers you need. Each server runs independently, so you can add/remove them as needed.\n\n### API connection errors\n\n1. Verify your API key is set correctly\n2. Check internet connection\n\n## Release Process\n\n### Publishing a Release\n\n1. Create a new release branch\n1. Update version in `pyproject.toml`\n1. Commit and push changes\n1. Create a pull request titled \"Release: YOUR FEATURE(s)\". Include detailed description of what's included in the release.\n1. Create a GitHub release with tag `vX.Y.Z`\n1. GitHub Actions automatically publishes to PyPI\n\nThe package is available at: https://pypi.org/project/axiomatic-mcp/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Modular MCP servers for Axiomatic_AI",
"version": "0.0.2",
"project_urls": {
"Homepage": "https://github.com/axiomatic/ax-mcp",
"Issues": "https://github.com/axiomatic/ax-mcp/issues"
},
"split_keywords": [
"mcp",
" axiomatic",
" ai",
" fastmcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "83820dcb6fc6b4c4ab452fafce6c121c0a1fd613309c9337d77987490b95d9ee",
"md5": "0e86242852a250c071b02cccafb615ca",
"sha256": "d0b55d0f8c2024309924d40a3ef26958339fbc542288dc80d35315f18879cf1f"
},
"downloads": -1,
"filename": "axiomatic_mcp-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e86242852a250c071b02cccafb615ca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 10408,
"upload_time": "2025-08-20T17:19:55",
"upload_time_iso_8601": "2025-08-20T17:19:55.979042Z",
"url": "https://files.pythonhosted.org/packages/83/82/0dcb6fc6b4c4ab452fafce6c121c0a1fd613309c9337d77987490b95d9ee/axiomatic_mcp-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "994e053ef39cd042d67c2974740806c6ff6a2f236a29b7c0f530cde2d87a6bc5",
"md5": "c69db734da10cd64b4a7f92d35f8a5bd",
"sha256": "d0250aabd8a16c01411f9690c60dc61d5b974f73ed8bfaf594929b155a35e068"
},
"downloads": -1,
"filename": "axiomatic_mcp-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "c69db734da10cd64b4a7f92d35f8a5bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 9638,
"upload_time": "2025-08-20T17:19:57",
"upload_time_iso_8601": "2025-08-20T17:19:57.483569Z",
"url": "https://files.pythonhosted.org/packages/99/4e/053ef39cd042d67c2974740806c6ff6a2f236a29b7c0f530cde2d87a6bc5/axiomatic_mcp-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-20 17:19:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "axiomatic",
"github_project": "ax-mcp",
"github_not_found": true,
"lcname": "axiomatic-mcp"
}
