# Sequence Mcp

> MCP server for the Sequence Banking API

- **Type:** MCP server
- **Install:** `agentstack add mcp-roaming-panda-llc-sequence-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [roaming-panda-llc](https://agentstack.voostack.com/s/roaming-panda-llc)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [roaming-panda-llc](https://github.com/roaming-panda-llc)
- **Source:** https://github.com/roaming-panda-llc/sequence-mcp

## Install

```sh
agentstack add mcp-roaming-panda-llc-sequence-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Sequence Banking MCP Server

[](https://github.com/markng/sequence-mcp/actions/workflows/ci.yml)
[](https://codecov.io/gh/markng/sequence-mcp)

> **⚠️ UNOFFICIAL:** This is an unofficial, community-built MCP server. It is not affiliated with, endorsed by, or supported by Sequence.

An MCP (Model Context Protocol) server that provides access to the [Sequence](https://getsequence.io) banking API. This allows AI assistants like Claude to interact with your Sequence accounts programmatically.

## Features

- **Get Accounts**: Fetch all financial accounts (Pods, Income Sources, external accounts) with current balances
- **Trigger Rules**: Invoke automation rules configured in Sequence from external systems

## Requirements

- Python 3.10 or higher
- A Sequence account with the External API enabled
- Access token and/or rule API secrets from your Sequence dashboard

## Installation

1. Clone or download this repository

2. Create and activate a virtual environment:
   ```bash
   python3 -m venv venv
   source venv/bin/activate
   ```

3. Install the package:
   ```bash
   pip install -e .
   ```

4. For development (includes test dependencies):
   ```bash
   pip install -e ".[dev]"
   ```

## Configuration

### Getting Your Credentials

1. **Enable the External API**: Go to Settings > Enable Remote API in your Sequence dashboard

2. **Generate an Access Token**: Navigate to Account Settings > Access Tokens and create a new token. This is used for fetching account data.

3. **Get Rule API Secrets**: When you create a Rule with "Remote API" trigger type, an API secret is generated. Use this secret to trigger that specific rule.

### Environment Variables

Set your access token as an environment variable:

```bash
export SEQUENCE_ACCESS_TOKEN="your_access_token_here"
```

## Usage

### Running the MCP Server

```bash
source venv/bin/activate
python -m sequence_mcp.server
```

### Using with Claude Desktop

Add the following to your Claude Desktop configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "sequence": {
      "command": "/path/to/sequence-mcp/venv/bin/python",
      "args": ["-m", "sequence_mcp.server"],
      "env": {
        "SEQUENCE_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}
```

Replace `/path/to/sequence-mcp` with the actual path to this project.

### Available Tools

#### get_accounts

Fetches all financial accounts with their current balances.

**Requirements**: `SEQUENCE_ACCESS_TOKEN` environment variable must be set.

**Returns**: List of accounts with id, name, type, and balance information.

#### trigger_rule

Triggers an automation rule in Sequence.

**Parameters**:
- `rule_id` (required): The ID of the rule to trigger (e.g., "ru_12345")
- `api_secret` (required): The API secret associated with this rule
- `payload` (optional): JSON object to send with the trigger
- `idempotency_key` (optional): Unique key to prevent duplicate triggers on retry

## Development

### Setup

```bash
# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate

# Install development dependencies (includes testing tools)
pip install -e ".[dev]"
```

### Running Tests

```bash
# Run all tests
pytest -v

# Run with coverage report
pytest --cov=sequence_mcp

# Run specific test file
pytest tests/test_client.py -v

# Run specific test function
pytest tests/test_client.py::describe_SequenceClient::describe_get_accounts -v
```

Tests use `pytest-describe` for BDD-style organization and `respx` for HTTP mocking.

### Project Structure

```
sequence-mcp/
├── sequence_mcp/
│   ├── __init__.py      # Package exports
│   ├── models.py        # Pydantic models for API responses
│   ├── client.py        # Async HTTP client for Sequence API
│   └── server.py        # MCP server implementation
├── tests/
│   ├── conftest.py      # Shared test fixtures
│   ├── test_models.py   # Model tests
│   ├── test_client.py   # Client tests
│   └── test_server.py   # Server tests
├── pyproject.toml       # Project configuration
└── README.md
```

## API Reference

This MCP server wraps the Sequence External API. For full API documentation, see:
https://support.getsequence.io/hc/en-us/articles/42813911824019-API-Overview

### Error Codes

| Code | Description |
|------|-------------|
| `INVALID_ACCESS_TOKEN` | Access token is missing or invalid |
| `INVALID_API_SECRET` | Rule API secret is incorrect |
| `INVALID_REQUEST` | Rule ID not found or not configured for API triggers |
| `TOO_MANY_REQUESTS` | Rate limit exceeded, slow down requests |
| `UNEXPECTED_ERROR` | Server error, usually transient |

## Security Notes

- Keep your access tokens and API secrets secure
- Never expose credentials in client-side code
- Use environment variables or secure secret management
- Rotate tokens periodically
- All requests are made over HTTPS

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [roaming-panda-llc](https://github.com/roaming-panda-llc)
- **Source:** [roaming-panda-llc/sequence-mcp](https://github.com/roaming-panda-llc/sequence-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-roaming-panda-llc-sequence-mcp
- Seller: https://agentstack.voostack.com/s/roaming-panda-llc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.