MCP (Model Context Protocol) servers that provide AI assistants with access to the Axiomatic_AI Platform - a suite of advanced tools for scientific computing, document processing, and photonic circuit design.

• Python
  • Install here
• uv
  • Install here
  • Recommended not to install in conda (see Troubleshooting)
• install extra packages (optional)
  • If you wish to use the AxPhotonicsPreview, you will need to install extra dependencies before continuing. After installing uv, run uv tool install "axiomatic-mcp[pic]".

Cursor installation

You will receive an API key by email shortly after filling the form. Check your spam folder if it doesn't arrive.

claude mcp add axiomatic-mcp --env AXIOMATIC_API_KEY=your-api-key-here -- uvx --from axiomatic-mcp all

{
  "mcpServers": {
    "axiomatic-mcp": {
      "command": "uvx",
      "args": ["--from", "axiomatic-mcp", "all"],
      "env": {
        "AXIOMATIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "axiomatic-mcp": {
    "command": "uvx",
    "args": ["--from", "axiomatic-mcp", "all"],
    "env": {
      "AXIOMATIC_API_KEY": "your-api-key-here"
    }
  }
}

{
  "axiomatic-mcp": {
    "command": "uvx",
    "args": ["--from", "axiomatic-mcp", "all"],
    "env": {
      "AXIOMATIC_API_KEY": "your-api-key-here"
    }
  }
}

[mcp_servers.axiomatic-mcp]
command = "uvx"
args = ["--from", "axiomatic-mcp", "all"]
env = { AXIOMATIC_API_KEY = "your-api-key-here" }

{
  "command": "uvx",
  "args": ["--from", "axiomatic-mcp", "all"],
  "env": {
    "AXIOMATIC_API_KEY": "your-api-key-here"
  }
}

Note: This installs all tools except for AxPhotonicsPreview under one server. If you experience other issues, try individual servers instead.

Found a bug? Please help us fix it by creating a bug report.

Join our Discord to engage with other engineers and scientists using Axiomatic Operators. Ask for help, discuss bugs and features, and become a part of the Axiomatic community!

It's not recommended to install axiomatic operators inside a conda environment. uv handles seperate python environments so it is safe to run "globally" without affecting your existing Python environments

1. Restart Cursor after updating MCP settings
2. Check the Output panel (View → Output → MCP) for errors
3. Verify the command path is correct

We have seen reports of the cursor window not opening correctly. If this happens you may manually add to cursor by:

1. Open cursor
2. Go to "Settings" > "Cursor Settings" > "MCP & Integration"
3. Click "New MCP Server"
4. Add the following configuration:

{
  "mcpServers": {
    "axiomatic-mcp": {
      "command": "uvx --from axiomatic-mcp all",
      "env": {
        "AXIOMATIC_API_KEY": "YOUR API KEY"
      },
      "args": []
    }
  }
}

Install only the domain servers you need. Each server runs independently, so you can add/remove them as needed.

1. Verify your API key is set correctly
2. Check internet connection

If you experience any issues such as tools not appearing, it may be that you are using an old version and need to clear uv's cache to update it.

uv cache clean

Then restart your MCP client (e.g. restart Cursor).

This clears the uv cache and forces fresh downloads of packages on the next run.

You may find more information about each server and how to install them individually in their own READMEs.

Compose equation of your interest based on information in the scientific paper.

Convert PDF documents to markdown with advanced OCR and layout understanding.

Create intelligent annotations for PDF documents with contextual analysis, equation extraction, and parameter identification.

Design photonic integrated circuits using natural language descriptions. Additional requirements are needed, please refer to Check system requirements

Extract numerical data from plot images for analysis and reproduction.

Have an idea for a new feature? We'd love to hear it! Submit a feature request and:

• Describe the problem your feature would solve
• Explain your proposed solution
• Share any alternatives you've considered
• Provide specific use cases

• Join our Discord Server
• Issues: GitHub Issues