niwashi-mcp

MCP server for Cisco ACI (APIC). It reads the fabric's own object model rather than a fixed list of endpoints, so an LLM agent can navigate all 15,452 ACI classes through five generic tools — with no hardcoded class knowledge.

uvx niwashi-mcp

No repository to clone, no schema bundle to download. The object model ships inside the niwaki dependency as an embedded catalogue.

Configure

Three variables, in a .env file or the environment:

APIC_HOST=10.0.0.1
APIC_USER=admin
APIC_PASSWORD=…

Optional: APIC_VERIFY_SSL (default false), MCP_PORT (default 8000), MCP_API_KEYS (comma-separated bearer tokens — unset means no authentication, and the server says so loudly at startup), NIWASHI_MCP_ENV_FILE (explicit path to the .env).

The five tools

Tool Purpose
search_classes find the exact ACI class name from a keyword
get_schema identifiers, containment, relations, properties of a class
query filtered class query against the APIC
get_by_dn fetch one object directly by DN
count count objects without transferring them

The intended order is search_classes → get_schema → query. Skipping the first two returns empty results silently, because the APIC answers 200 OK with an empty list for an unknown class or attribute — it does not error.

Documentation

Full documentation, architecture notes and deployment guides: https://github.com/k3l0-dev/niwashi-mcp

The repository also carries mcp/client/SKILL.md — the operating guide to give an LLM client alongside the server. It teaches the ACI object model, the mandatory tool order, and how to read a relation without concluding wrongly.

Requirements

Python ≥ 3.12. A reachable APIC and a read-only service account.

Licence

PolyForm Noncommercial 1.0.0 — free for personal, research and noncommercial use. Commercial deployment or integration requires a commercial licence: monark.aiops@pm.me.

Cisco, Cisco ACI and APIC are trademarks of Cisco Systems, Inc. niwashi-mcp is an independent project, not affiliated with or endorsed by Cisco Systems, Inc.

Project links

Data verified by PyPI on Aug 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for k3l0-dev from gravatar.com k3l0-dev

Credits

Author/Maintainer: Khalid El-Ouiali

GitHub Statistics

Data verified by PyPI on Aug 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Other/Proprietary License (PolyForm-Noncommercial-1.0.0)

Requires

Python >=3.12

Tags

aci apic cisco llm mcp network-automation niwaki

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

niwashi_mcp-2.0.0.tar.gz (461.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

niwashi_mcp-2.0.0-py3-none-any.whl (57.3 kB view details)

Uploaded Python 3

File details

Details for the file niwashi_mcp-2.0.0.tar.gz.

File metadata

  • Download URL: niwashi_mcp-2.0.0.tar.gz
  • Upload date:
  • Size: 461.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for niwashi_mcp-2.0.0.tar.gz
Algorithm Hash digest
SHA256 94d9235822b36ba4abfd1623bb0d485cd8e2f212420024092ed8636cc1922aae
MD5 64de69ca45ce4f0151012c0a863824c9
BLAKE2b-256 9c576915d38a17ce75fc4a0695a3e53f126ef77ab6e5c5395a0bd80f44770624

See more details on using hashes here.

Provenance

The following attestation bundles were made for niwashi_mcp-2.0.0.tar.gz:

Publisher: release.yml on k3l0-dev/niwashi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file niwashi_mcp-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: niwashi_mcp-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 57.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for niwashi_mcp-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d612d5327ee3f18f2882820d890a562c41a0f98a9a7ff3c74aa41a940582e001
MD5 9509a21a7c33b2644fb1b6dd0336f2e6
BLAKE2b-256 9d3216eefd14e91d413e7c5c2db5b2e5ad86fbdf9892e519fa3516987f0e627b

See more details on using hashes here.

Provenance

The following attestation bundles were made for niwashi_mcp-2.0.0-py3-none-any.whl:

Publisher: release.yml on k3l0-dev/niwashi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page