Back to the catalog

io.github.daedalus/mcp-oeis

MCP server for the OEIS (Online Encyclopedia of Integer Sequences) API

Open source Open in the app JSON README (API)

About

MCP server for the OEIS (Online Encyclopedia of Integer Sequences) API

Details

Kind
MCP servers
Topic
No topic detected
Publisher
daedalus
Origin
official
Category
ferramentas
Transport
local
Version
0.1.0
Stars
1
Forks
1
Open pull requests
1
Last push
2026-04-21T19:27:21Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-08-29 03:02:40
Updated
2026-08-29 03:02:40
Origin id
io.github.daedalus/mcp-oeis

README

# mcp-oeis

> MCP server for the OEIS (Online Encyclopedia of Integer Sequences) API

mcp-name: io.github.daedalus/mcp-oeis

[![PyPI](https://img.shields.io/pypi/v/mcp-oeis.svg)](https://pypi.org/project/mcp-oeis/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-oeis.svg)](https://pypi.org/project/mcp-oeis/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

## Install

```bash
pip install mcp-oeis
```

## Usage

### As an MCP Server

Configure in your MCP settings:

```json
{
  "mcpServers": {
    "mcp-oeis": {
      "command": "mcp-oeis"
    }
  }
}
```

### Python API

```python
from mcp_oeis import mcp

# Get a sequence by ID
result = mcp.get_sequence_by_id("A000109")
print(result["terms"])  # [1, 1, 1, 2, 5, 14, ...]

# Search by terms
results = mcp.search_by_terms([1, 1, 2, 3, 5, 8])
print(results[0]["name"])  # "Fibonacci numbers"

# Search by name
results = mcp.search_by_name("prime")
print(results[0]["id"])  # "A000040"
```

## MCP Tools

### get_sequence_by_id
Get a sequence by its OEIS ID (e.g., "A000109" for simplicial polyhedra, "A000045" for Fibonacci).

### search_by_terms
Search OEIS sequences by providing integer terms. For example, searching [1,1,2,3,5,8] will find the Fibonacci sequence.

### search_by_name
Search OEIS sequences by name or keyword. For example, searching "Fibonacci" will find Fibonacci-related sequences.

## Development

```bash
git clone https://github.com/daedalus/mcp-oeis.git
cd mcp-oeis
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/
```

More