Quill
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
last-reviewed: 2026-07-07 status: active
MapleSpike — Quill
Data-layer MCP product: MapleSpike Quill — Quill reads Canada so your AI doesn't have to lie about it.
MVP acceptance: docs/MVP.md locks the ship scope (#790).
Status: Active development · License: AGPL-3.0-only · Stack: TypeScript + Python + NixOS/K3s (backend) · Astro + React + Tailwind v4 (portal) + Quill (data-layer MCP)
Repo rename note (2026-07): Working-directory renamed
maplespike/→quill/. Product-level identifiers (container images, K8s resources, Nix outputs, Helm chart) are nowquill-*. Brand-level identifiers — the GitHub remote (git@github.com:maplespike/quill.git),@maplespike/*npm scope,maplespike.cadomain,*.maplespike.lanDNS, K8s namespacemaplespike, PostgreSQL user — are preserved. See ADR 0007 for the full decision record and CHANGELOG.md for the executed diff.Current metrics: docs/metrics.json — 207 modules, 185 MCP tools (incl.
x402-deposit), ~220K lines TS, 14 packages.
Related MCP server: DataBook
What it is
MapleSpike searches, ingests, verifies, and surfaces 207 data modules from Canadian government and other public-sector sources. Source terms vary by publisher and dataset; public availability does not establish reuse permission.
Coverage:
Federal core: IRCC immigration, StatCan WDS (CPI/GDP/labour/pop/trade), Health Canada, CRA Charity, Federal Budget, Proactive Disclosure, ATI, NPRI, Species at Risk, Impact Assessment, CIPO, CMHC
Parliament & committees: House and Senate committees, Hansard, Canada Gazette, LEGISinfo
Regulatory & oversight: OAG, PBO, Ethics Commissioner, Lobbying Commissioner, Competition Bureau, CRTC, Privacy Commissioner, Information Commissioner, Official Languages, CHRC, OSFI, FCAC, FINTRAC, CDIC
Corporate & influence: Lobbying registry, procurement, SEDI insider trades, SEDAR+ filings, corporations Canada, 31 NGO/think tank RSS feeds, WEF narrative tracking
Provincial: All 13 legislatures, 13 CKAN portals, 273 regulators across 21 categories (securities, law societies, police SIU, engineering, medical, teaching, etc.)
Municipal: 19 cities with direct open data fetchers, 3,490+ via provincial CKAN federation, regional authorities (Peel, York, Durham, Metro Vancouver, CRD)
Justice & legal: CanLII case law, A2AJ 116K+ decisions, Justice Canada legislation XML, federal tribunals, Ontario e-Laws, BC Laws
Real-time: ECCC weather alerts (CAP-CP), CBSA border wait times, parole board decisions
Unions & labour: CUPE, Unifor, PSAC annual reports, StatCan aggregates
Universities: CUDO enrolment data, Tri-Council grants, per-institution CKAN
Media & broadcasting: CRTC market reports, ownership charts, Canada Media Fund, Telefilm, Online News Act
Defence & veterans: DND personnel, procurement
SDK: @maplespike/sdk — typed TypeScript client (dual CJS/ESM). See docs/metrics.json for current module coverage.
Records may include SHA-256 hashes, source provenance, and audit-trail metadata. Hashes support integrity comparisons; they do not establish source authenticity or reuse rights.
Current metrics: See docs/metrics.json for current module/tool/line counts. All packages compile clean, SDK tests passing. Cross-reference engine connects lobbying ↔ committees ↔ GIC ↔ contracts ↔ elections.
Repository structure
quill/
├── packages/
│ ├── pipeline-core/ # Ingestion, verification, audit (shared library)
│ ├── engine/ # Entity resolution, graph building, signals, briefs
│ ├── portal/ # Developer portal & landing page (Astro + React + Tailwind)
│ ├── api-server/ # REST API gateway (auth, rate limits, usage)
│ ├── quill-mcp/ # Quill — data-layer MCP server (✅ 185 tools (incl. `x402-deposit`), all live)
│ ├── sdk/ # TypeScript client library (@maplespike/sdk)
│ ├── sdk-python/ # Python client library (`quill-sdk` on PyPI)
│ ├── legal-core/ # Legal data SDK
│ └── legislation/ # Legislation XML parser
├── docs/ # Architecture docs, roadmap, gap analysis, MVP checklist (`docs/MVP.md`)
├── CONTRIBUTING.md # Contributor guide
├── .hermes/ # Analysis plans and retrospectives
├── .sisyphus/ # Orchestration plans
├── flake.nix # Nix build (delegates to nixos-config)
├── ROADMAP.md # Full phased roadmap & file inventory
└── tsconfig.json # Shared TypeScript configurationBuild Plan (7 Phases)
pipeline-core ──→ SQLite DB ──→ MCP server (185 live tools (incl. `x402-deposit`)) ──→ Dashboard / Console
│ │
└── Engine reads same DB ──→ briefs/signals ─────────────────┘
│
Portal (Astro/React) ──┘Phase | What | Status |
1 | Shared DB — D1 interface → | ✅ DONE |
2 | Wire Ingestion — corporate CSV parse + DB insert, influence real queries | ✅ DONE |
3 | Wire MCP — 185 tools (incl. | ✅ DONE |
4 | Engine integration — entity resolution + brief gen reads shared DB | ✅ DONE |
5 | Live Dashboard — hits MCP/API for live data | ✅ DONE |
6 | SaaS / Public API — Stripe + crypto + Interac billing, developer console | 🟡 Stripe live (checkout, webhooks, portal, expiry reconciliation); crypto/Interac pending |
7 | CI/CD + White-Label — GitHub Actions, enterprise tenants, journalism mode | 🔴 TODO |
See ROADMAP.md for the full phased plan. Detailed architecture: docs/ARCHITECTURE.md.
Quick start
# Clone (repo name is now `quill` — formerly `maplespike`)
git clone git@github.com:maplespike/quill.git
cd quill
# Install dependencies
pnpm install
# Build all packages
pnpm run build
# Start MCP server (local stdio)
cd packages/quill-mcp
pnpm startAll 185 MCP tools return real data — committees, corporate, influence, and government data are all searchable via the SQLite database. No external database configuration required for MCP tools.
For full deployment guide, see docs/DEPLOYMENT.md
Running the local development stack & smoke test
The scripts/dev-up.sh wrapper handles env bootstrap, image build,
and docker compose orchestration so you don't have to remember the
exact incantation. scripts/e2e-smoke.sh confirms all three runtime
services came up healthy. Both scripts live in the repo so they stay
authoritative — prefer them over raw docker compose, which has known
port-mapping and fallback behaviour drift across v1 and v2.
Prerequisites
Docker Desktop 4.x+ or the
docker-compose-plugin(the wrapper prefersdocker compose, falls back todocker-composev1)~4 GB of free RAM for the three service containers
Ports
8082(API),3001(MCP),8080(Portal) free on the hostNo host-side
pnpm installneeded — the Dockerfile runspnpm installinside each image build
Bring the stack up
# First run: builds images if needed, boots in the foreground,
# waits for /v1/health to respond, then tails logs.
./scripts/dev-up.sh
# Detached — returns immediately (useful in tmux or CI).
./scripts/dev-up.sh --detach
# Force a full rebuild after editing the Dockerfile or docker-compose.yml.
./scripts/dev-up.sh --rebuild
# Tail logs of an already-running stack.
./scripts/dev-up.sh --logs
# Tear back down (removes containers + orphans; .env is preserved).
./scripts/dev-up.sh --downThe wrapper auto-copies .env.example → .env on the first run so the
API and MCP have non-empty JWT_SECRET / QUILL_API_KEY defaults.
Edit .env to override any of: API storage backend (memory /
sqlite / postgres), ports, CORS origins, AI gateway URL, or
Postgres connection settings. Re-run ./scripts/dev-up.sh --down && ./scripts/dev-up.sh
to pick up .env changes.
Run the end-to-end smoke test
# Self-contained: bring the stack up, hit every endpoint, tear down.
./scripts/e2e-smoke.sh --mode=compose --up --down
# Or, against an already-running stack (e.g. one you started with --detach).
./scripts/e2e-smoke.sh --mode=local
# Target custom hosts / ports (staging, prod mirror, etc.).
./scripts/e2e-smoke.sh --mode=local \
--api=http://staging.lan:8082 \
--portal=http://staging.lan:8080 \
--mcp=http://staging.lan:3001The smoke test first waits (up to 60s) for the bootstrap endpoints ($API_URL/v1/health, $PORTAL_URL/, $MCP_URL/health) to respond, then runs the explicit assertions below:
Check | Endpoint | Expects |
API health |
|
|
API modules |
| non-empty |
API OpenAPI |
| valid OpenAPI 3.x doc |
Portal index |
| HTML containing |
MCP health |
|
|
Exit codes:
0— all checks passed1— one or more checks failed; the output tail suggests./scripts/dev-up.sh --logsto investigate2— missing dependency (compose plugin) or bad args
After the stack is up
Service | URL |
Portal (Astro static + | |
API | |
API OpenAPI | |
MCP (HTTP / SSE) |
Stop the entire stack with ./scripts/dev-up.sh --down.
Data sources
Source | Method | Coverage |
House of Commons committees | XML evidence fetch | 30 committees, Hansard transcripts, in-camera flags |
Senate committees | XML evidence fetch | 20 committees via sencanada.ca |
Lobbying Registry (OCL) | CKAN CSV dump | All federal lobbying since 1996 |
Canada Gazette | RSS + detail fetch | Parts I (proposed), II (enacted), III (acts) regulations |
GIC Appointments | CKAN + Infobase API | Governor-in-Council appointments, order-in-council |
CanadaBuys / procurement | RSS + CKAN | Tender notices, contract awards, proactive disclosure |
Provincial Lobbying | CKAN + registry search | All 13 provinces/territories |
Elections Canada | CKAN + HTML parse | Third-party advertiser registry, spending reports |
CRA Charities | HTML search | Registered charity financials, directors, programs |
Executive statements | RSS (GlobeNewswire + IR feeds) | 17 tracked executives across banking, telecom, media |
Influence actors | Catalog + CKAN | 32 IOs, NGOs, think tanks, consultancies |
Oversight Bodies | RSS + HTML + JSON APIs | OAG, PBO, Ethics Commissioner, Lobbying Commissioner, Competition Bureau, CRTC |
CanLII Court Decisions | REST API | Federal and provincial courts, citation graphs |
LMIA | CKAN CSV | ESDC quarterly LMIA data, employer/occupation search |
Statistics Canada | WDS/SDMX API | Economic, demographic, health data |
open.canada.ca | CKAN API | Federal open data portal |
Provincial portals | CKAN API | ON, BC, AB, QC |
Deployment
Current Deployment: Docker Compose for local development via
./scripts/dev-up.sh(API: :8082, MCP: :3001, Portal: :8080)Planned: K8s deployment in ROADMAP.md Phase 3
Container images:
quill-mcp:dev,quill-api:dev,quill-portal:dev
The authoritative contributor recipe is Running the local development stack & smoke test above — use scripts/dev-up.sh and scripts/e2e-smoke.sh instead of raw docker-compose up -d (the v1 binary is not installed on hosts that ship only the docker compose plugin).
For production-grade deployment notes, see docs/DEPLOYMENT.md.
Infrastructure Status:
✅ Docker Compose — Working (local development via
scripts/dev-up.sh)✅ Cloudflare Tunnel — Live for
quill.maplespike.ca/api.maplespike.ca/mcp.maplespike.ca✅ Cloudflare Pages — Live for
maplespike.ca+www.maplespike.ca(brand site)🟡 Production cutover — Track in ROADMAP.md Phase 4 (Mosaic deploy + Stripe live + cronjobs + secrets)
All backend data stays on Canadian infrastructure with zero external cloud spend.
CI/CD
GitHub Actions drives the two-environment deployment model:
Branch | Workflow | Action |
| CI (ci.yml) | Run tests on every push |
| Deploy Dev (deploy-dev.yml) | Build + deploy to |
| Deploy Prod (deploy-prod.yml) | Build + deploy to |
Container images are tagged :dev for dev builds and :latest for production. Each workflow builds, pushes to the registry, and applies the corresponding k8s/dev/ or k8s/prod/ Kubernetes manifests.
Related projects
Frostbite Gazette — AI-curated Canadian political journalism (first-class maplespike consumer)
mcp-canada — Canadian government MCP tools (precursor to MapleSpike)
Licensing
Quill is licensed under the GNU Affero General Public License, version 3 only
(AGPL-3.0-only). Every workspace package declares the same licence,
every first-party source file carries the same SPDX-License-Identifier, and each
published package ships a copy of the licence text. LICENSE.md
records the decision and its scope.
NOTICE carries the third-party and public-data notices. It holds the
Open Government Licence – Canada attribution, the Crown copyright statement, the
House of Commons and Senate reproduction permissions, the Reproduction of Federal
Law Order notice, and the licence notices for vendored and adapted material.
Source-data terms are separate from software licenses. They vary by publisher and dataset. Quill does not grant independent reuse rights in source material. Required attribution statements and notices are listed in DATA-LICENSES.md (mirrored on the site at /data-sources); see the data-source audit and consult the original publisher's terms.
How this is built
Quill is developed by a fleet of autonomous agents under human direction.
docs/AGENT-WORKFLOW.md explains the workflow, the
rules it runs under, and how to contribute without it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.
Canadian public-sector data and legal information for AI agents, paid per call in USDC over x402
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server giving AI agents structured access to Canadian federal, provincial, and municipal government data.4573 PyPI62MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage and query SQLite databases through MCP tools, supporting CRUD operations, schema management, and saved views.4 npmMIT
- AlicenseAqualityBmaintenanceGives AI agents structured, typed access to Canadian open data through a single server covering Statistics Canada tables, Census and public use microdata, the Bank of Canada, CMHC, federal agencies and federal, provincial, territorial and municipal open-data portals, in English and French. It offers roughly 200 tools for querying, planning multi-source queries, and generating reproduction code in R, Python, Stata or Julia.3276 PyPI7MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query normalized US government data from SAM.gov, USAspending, Grants.gov, US House STOCK Act trades, and SEC EDGAR through 19 read-only tools covering contracts, awards, grants, congressional trades, insider filings, holdings, and financial fundamentals.1MIT No Attribution