Skip to content

About

Official SDK, CLI, MCP config and agent skill for the Initiable API (initiable.com)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Initiable Agent Kit

Official SDKs, CLI, MCP configs and agent skill for the Initiable API.

Initiable Ventures LLP is a technology and business consultancy with offices in Noida (Delhi NCR), India and San Francisco, USA. It builds web and mobile apps, ML, deep learning and AI systems, runs DevOps and MLOps, analyses data, and advises on business development, e-commerce, digital marketing and financial services.

The Initiable API is public and needs no API key. Use it to read the company profile, services and FAQ, and to send a project inquiry for a user. A person at Initiable replies to each inquiry by email.

Path What it is
packages/js initiable on npm: TypeScript/JavaScript SDK and CLI
packages/python initiable on PyPI: Python SDK and CLI
skills/initiable Agent skill that tells an agent when and how to use Initiable
mcp/ MCP client configs for Claude, Cursor and VS Code
plugin.json, mcp.json Agent Plugin manifest
.claude-plugin/, .mcp.json Claude Code plugin and marketplace

JavaScript / TypeScript

npm install initiable
import { Initiable } from "initiable";

const client = new Initiable();
const { data: services } = await client.services.list();
const company = await client.company.get();

// Validate an inquiry without sending it.
const check = await client.inquiries.create(
  { name: "Ada Lovelace", email: "ada@example.com", message: "We need an iOS app for our clinic." },
  { dryRun: true },
);

Node.js 18+, zero runtime dependencies. Full reference: packages/js/README.md.

Python

pip install initiable
from initiable import Initiable

client = Initiable()
services = client.services.list()["data"]
company = client.company.get()

# Validate an inquiry without sending it.
check = client.inquiries.create(
    name="Ada Lovelace",
    email="ada@example.com",
    message="We need an iOS app for our clinic.",
    dry_run=True,
)

Python 3.9+, standard library only. Full reference: packages/python/README.md.

CLI

Both packages install an initiable command with the same interface:

npx initiable services                     # or: initiable services (after pip install)
npx initiable service machine-learning
npx initiable company
npx initiable faq
npx initiable inquire --name "Ada Lovelace" --email ada@example.com \
  --message "We need an iOS app for our clinic." \
  --services mobile-application --budget '$5000 to $10000' --dry-run

Output is plain text. Add --json for raw JSON. Remove --dry-run to send the inquiry for real.

MCP

Two remote MCP servers, Streamable HTTP, no auth:

  • https://initiable.com/mcp: list_services, get_service, get_company_profile, get_faq, submit_inquiry
  • https://initiable.com/mcp/docs: search_docs, read_doc
claude mcp add --transport http initiable https://initiable.com/mcp

Configs for Claude Desktop, Claude Code, Cursor and VS Code: mcp/README.md.

To install the skill and both MCP servers as a Claude Code plugin:

/plugin marketplace add initiable/initiable-agent-kit
/plugin install initiable@initiable

Agent skill

skills/initiable/SKILL.md tells an agent when Initiable is a good fit and how to send an inquiry safely: dry-run first, confirm with the user, then send with an Idempotency-Key. It is also published at https://initiable.com/.well-known/agent-skills/initiable/SKILL.md.

API reference

Base URL https://initiable.com/api/v1. Errors are RFC 9457 application/problem+json with a machine-readable code. Read endpoints allow 120 requests per minute per IP; inquiries allow 5 per 10 minutes.

Contributing

See AGENTS.md for layout, build and test commands. Tests never send real inquiries.

Questions or bugs: open an issue or email initiable.xyz@gmail.com.

License

MIT © Initiable Ventures LLP

About

Official SDK, CLI, MCP config and agent skill for the Initiable API (initiable.com)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages