Skip to main content
Glama
chaituredd

DoorDash MCP Server

by chaituredd

DoorDash MCP Server

MCP server that wraps DoorDash's Drive API. Lets AI agents (Claude, Cursor, etc.) search restaurants, place delivery orders, and track them in real time.

Comes with built-in mock data so you can try it without DoorDash API credentials.

Architecture

graph TB
    subgraph "MCP Clients"
        C1[Claude Desktop]
        C2[Cursor]
        C3[Claude Code]
    end
    
    subgraph "MCP Server"
        T[Transport - stdio / SSE]
        S[Server Core]
        
        subgraph "Tools"
            RT[Restaurant Tools]
            DT[Delivery Tools]
            TT[Tracking Tools]
            AT[Account Tools]
        end
        
        subgraph "Service Layer"
            MC[Mock Client]
            DC[DoorDash Client]
        end
    end
    
    DD[DoorDash Drive API]
    
    C1 & C2 & C3 --> T
    T --> S
    S --> RT & DT & TT & AT
    RT & DT & TT & AT --> MC
    RT & DT & TT & AT -.->|live mode| DC
    DC --> DD

Related MCP server: DoorDash MCP Server

Quick Start

No API keys needed — mock mode is the default:

git clone https://github.com/chaituredd/doordash-mcp-server.git
cd doordash-mcp-server
npm install && npm run build

The build step prints the MCP client config JSON. Paste it into your Claude Desktop or Cursor settings.

Or with Docker:

docker compose -f docker/docker-compose.yml up

Tools

12 tools across 4 domains:

Tool

What it does

Mock

Live

search_restaurants

Find nearby restaurants

✓

✓

get_menu

Full menu with prices and modifiers

✓

✓

get_restaurant_details

Hours, ratings, delivery info

✓

✓

create_delivery_quote

Fee estimate, valid for 5 min

✓

✓

accept_delivery_quote

Confirm quote → start delivery

✓

✓

create_delivery

Skip the quote, create directly

✓

✓

cancel_delivery

Cancel before pickup

✓

✓

get_delivery_status

Status timeline + ETA

✓

✓

list_active_deliveries

All in-progress deliveries

✓

✓

get_business_info

Business account details

✓

✓

list_stores

Stores under a business

✓

✓

create_store

Register a new store

✓

✓

Configuration

Copy .env.example to .env:

Variable

Required

Default

Description

DOORDASH_API_MODE

No

mock

mock or live

TRANSPORT

No

stdio

stdio or http

PORT

No

3000

Port when using HTTP transport

DOORDASH_DEVELOPER_ID

Live only

—

From DoorDash Developer Portal

DOORDASH_KEY_ID

Live only

—

From DoorDash Developer Portal

DOORDASH_SIGNING_SECRET

Live only

—

From DoorDash Developer Portal

MCP Client Config

Claude Desktop / Claude Code:

{
  "mcpServers": {
    "doordash": {
      "command": "node",
      "args": ["/absolute/path/to/doordash-mcp-server/build/index.js"],
      "env": {
        "DOORDASH_API_MODE": "mock"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "doordash": {
      "command": "node",
      "args": ["/absolute/path/to/doordash-mcp-server/build/index.js"]
    }
  }
}

Development

npm install          # install deps
npm run dev          # watch mode
npm test             # run tests
npm run test:watch   # tests in watch mode
npm run typecheck    # type checking

Project Layout

src/
├── index.ts          # entry point, transport setup
├── server.ts         # tool/resource/prompt registration
├── config.ts         # env validation (Zod)
├── tools/            # one file per tool domain
├── services/         # DoorDash clients (real + mock)
├── data/             # mock restaurants, menus, deliveries
├── types/
└── utils/            # logger, errors, validation

Live Mode

  1. Sign up at developer.doordash.com (sandbox is free)

  2. Grab your credentials and run:

DOORDASH_API_MODE=live \
DOORDASH_DEVELOPER_ID=your_id \
DOORDASH_KEY_ID=your_key \
DOORDASH_SIGNING_SECRET=your_secret \
npm start

New accounts start in sandbox. Production requires a separate application to DoorDash.

How It Works

Implements the Model Context Protocol spec. AI agents call tools through MCP, the server translates those into DoorDash Drive API requests (or returns mock data), and formats responses for the agent to show the user.

The mock layer is stateful — create a delivery and it'll progress through created → confirmed → enroute_to_pickup → picked_up → enroute_to_dropoff → delivered each time you check status. Makes demos actually useful.

Tech

TypeScript (strict), Node 18+, @modelcontextprotocol/sdk v1.x, Zod for validation, Axios for HTTP, Vitest for tests, GitHub Actions CI, Docker multi-stage build.

Why This Exists

Wanted to learn MCP properly by building something non-trivial with it. DoorDash's Drive API seemed like a good fit since it has a real delivery lifecycle to model. The mock layer turned out to be the most useful part — you can demo the whole flow without any API keys.

License

MIT

Related MCP Connectors

Related MCP Servers