numefa Agent API

REST + MCP for AI agents

Connect any AI agent to numefa. Everything an agent writes is a draft — a human approves it in the review inbox.

MCP · Streamable HTTPREST v1 · OpenAPINo send endpoint

Authentication

API keys look like nmf_live_… and are created by the user inside the app under Einstellungen → Verbinden. Send the key as a bearer token on every request. Keys carry scopes and can be revoked at any time.

HTTP header

Authorization: Bearer nmf_live_…

Never ship a key in client-side code. One key per agent keeps revocation surgical.

MCP server recommended

numefa hosts an MCP server at https://app.numefa.com/api/mcp over Streamable HTTP. It works with Claude (Code, Desktop, Web), ChatGPT connectors and Cursor — no SDK, no local process to babysit.

Tools (11)

get_context

list_projects

match_project

confirm_project_mapping

log_work

get_unbilled_summary

create_quote_draft

create_invoice_draft

suggest_new_project

list_customers

list_suggestions

— no send tool

Write tools return the id of the created draft, never a sent document.

Scopes

readlog_timedraft_quotesdraft_invoices

There is deliberately no send scope. Sending is not a permission that can be granted — the capability does not exist in the API surface at all.

Endpoints · REST v1

Base path https://app.numefa.com/api/v1. The machine-readable spec lives at GET /api/v1/openapi.

context

tenant, settings, current month

customers

read customer records

projects

read projects and rates

match

resolve free text to a project

work-sessions

log work · write

mappings

remember project assignment · write

project-suggestions

propose a new project · write

suggestions

read the review inbox

unbilled

open amounts and hours

quote-drafts

create a quote draft · write

invoice-drafts

create an invoice draft · write

openapi

full machine-readable spec

Rules for write requests

Idempotency-Key

Required on every write. Retries with the same key are safe and never create duplicates.

Rate limits

120 requests per minute, 500 writes per day and key.

Server-side math

Tax rates and totals are always calculated by the server — never by the agent.

Draft-first

Every write lands as a suggestion in the review inbox and waits for a human.

Quick start

Claude Code

claude mcp add --transport http numefa https://app.numefa.com/api/mcp \
  --header "Authorization: Bearer nmf_live_…"

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "numefa": {
      "type": "http",
      "url": "https://app.numefa.com/api/mcp",
      "headers": { "Authorization": "Bearer nmf_live_…" }
    }
  }
}

OpenAI / ChatGPT · connector

{
  "type": "mcp",
  "server_label": "numefa",
  "server_url": "https://app.numefa.com/api/mcp",
  "authorization": "Bearer nmf_live_…"
}

curl · log work

curl -X POST https://app.numefa.com/api/v1/work-sessions \
  -H "Authorization: Bearer nmf_live_…" \
  -H "Idempotency-Key: 7f1c2a" \
  -H "Content-Type: application/json" \
  -d '{"project":"webdesign-relaunch","minutes":150,"description":"Responsive Feinschliff"}'
→ 201 created · suggestion pending review

API-Key in der App erstellen

Einstellungen → Verbinden. Während der Beta kostenlos, Scopes frei wählbar.

Kostenlos zur Beta anmelden