Skip to content

Design: integration layer — tool wrappers vs MCP servers, auth, idempotency #2

Description

@gidutz

The integration layer is where agents act on real platforms. Largest surface area, where most of the value lives.

Scope decisions:

  • Tool wrappers (direct function calls) vs. MCP servers (separate processes)?
  • Auth model: token storage, refresh, per-account credentials
  • Idempotency: how do we ensure a retried "create campaign" call doesn't double-create?
  • Rate limiting and backoff per platform
  • Sandbox / dry-run mode for testing without spending money
  • Error taxonomy: distinguishing user error, platform error, transient failure

Deliverable: integration-layer architecture doc plus a reference implementation of one tool (tied to the vertical-slice platform decision in #7).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions